From b55200763e5d6a9ea9f4ca0193c9d12f272afb36 Mon Sep 17 00:00:00 2001 From: Addie Rudy Date: Wed, 20 Mar 2024 15:31:54 -0400 Subject: [PATCH] docs: Added development prioritization document --- docs/.vitepress/config.mts | 3 ++- docs/guide/prioritization.md | 41 ++++++++++++++++++++++++++++++++++++ 2 files changed, 43 insertions(+), 1 deletion(-) create mode 100644 docs/guide/prioritization.md diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index a24fd26b9..218e48c77 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -38,7 +38,8 @@ export default defineConfig({ text: 'Guide', items: [ { text: 'Deploy', link: '/guide/deploy' }, - { text: 'Developer Guide', link: '/guide/developers' } + { text: 'Developer Guide', link: '/guide/developers' }, + { text: 'Development Prioritization', link: '/guide/prioritization' }, ] }, { diff --git a/docs/guide/prioritization.md b/docs/guide/prioritization.md new file mode 100644 index 000000000..cb700df92 --- /dev/null +++ b/docs/guide/prioritization.md @@ -0,0 +1,41 @@ +# How We Prioritize: AWS GenAI Chatbot Solution + +## Introduction + +At AWS, we strive to deliver high-quality solutions that meet the evolving needs of our customers and the broader community. This document outlines our approach to prioritizing work for the AWS GenAI Chatbot Solution. + +## Document Purpose + +The purpose of this document is to provide transparency into the factors we consider when prioritizing work related to the AWS GenAI Chatbot Solution. Our goal is to deliver tangible value to our users on a predictable and frequent schedule, while maintaining a balance between community feedback, customer requests, partner collaborations, and internal priorities. + +## Prioritization Factors + +We prioritize work based on several factors, including community feedback, customer requests, partner collaborations, and internal priorities. While community feedback is heavily weighted, there may be instances where other factors take precedence. Here's a breakdown of the various sources of input we consider: + +### Community + +Our vibrant community of users and contributors plays a crucial role in shaping the direction of the AWS GenAI Chatbot Solution. We closely monitor and prioritize issues and pull requests that receive significant community attention, as indicated by reactions, comments, and links to related issues or PRs. Issues with the most community support are given high priority, and we strive to provide timelines for addressing them whenever possible. + +### Customer Requests + +We value feedback and feature requests from AWS customers, which are typically escalated through various channels, such as customer support, sales engineering, or AWS Solutions Architects. During a weekly triage process, we assess these requests based on the following criteria: + +- Community support for the requested feature or issue +- Relevance to our core services and offerings + +Customer requests with substantial community support or those pertaining to our core services are more likely to be prioritized. + + +### Internal Priorities + +In addition to external inputs, we consider several internal factors when prioritizing work: + +1. **SDK/Core Updates**: We strive to keep the AWS GenAI Chatbot Solution up-to-date with minor SDK releases, which are automatically pulled in through our automation processes. Major SDK releases with breaking changes may require us to release a new major version of the solution, which we aim to limit. + +2. **Technical Debt**: We allocate capacity for addressing technical debt in every iteration. Minor technical debt items can be addressed by engineers as needed, while larger items are discussed and prioritized during dedicated technical debt review meetings. + +3. **Adverse User Experience or Security Vulnerabilities**: Issues that negatively impact user experience, such as bugs or crashes, or those that pose security risks, are always given high priority for inclusion in upcoming releases. The severity of these issues determines how quickly they are addressed. + +## Conclusion + +At AWS, we strive to balance the diverse needs and inputs of our community, customers, partners, and internal stakeholders when prioritizing work for the AWS GenAI Chatbot Solution. By being transparent about our prioritization process, we hope to foster a better understanding of why certain features, improvements, or bug fixes are prioritized over others. We remain committed to delivering a high-quality solution that provides tangible value to our users on a predictable and frequent schedule. \ No newline at end of file