summaryrefslogtreecommitdiff
path: root/.gitlab/issue_templates/Feature proposal.md
diff options
context:
space:
mode:
Diffstat (limited to '.gitlab/issue_templates/Feature proposal.md')
-rw-r--r--.gitlab/issue_templates/Feature proposal.md23
1 files changed, 11 insertions, 12 deletions
diff --git a/.gitlab/issue_templates/Feature proposal.md b/.gitlab/issue_templates/Feature proposal.md
index 5987d35a3d2..dd8e125916e 100644
--- a/.gitlab/issue_templates/Feature proposal.md
+++ b/.gitlab/issue_templates/Feature proposal.md
@@ -4,8 +4,8 @@
### Target audience
-<!-- For whom are we doing this? Include either a persona from https://design.gitlab.com/getting-started/personas
-or define a specific company role. e.a. "Release Manager" or "Security Analyst" -->
+<!-- For whom are we doing this? Include either a persona from https://design.gitlab.com/getting-started/personas or define a specific company role. e.a. "Release Manager" or "Security Analyst".
+Use the persona labels as well https://gitlab.com/groups/gitlab-org/-/labels?utf8=%E2%9C%93&subscribed=&search=persona%3A -->
### Further details
@@ -13,25 +13,24 @@ or define a specific company role. e.a. "Release Manager" or "Security Analyst"
### Proposal
-<!-- How are we going to solve the problem? -->
+<!-- How are we going to solve the problem? Try to include the user journey! https://about.gitlab.com/handbook/journeys/#user-journey -->
### Documentation
-<!--
-* What doc pages need to be created or updated across user, admin, and API docs?
-* What concepts, procedures, or information is needed in each area? Is there an 'old way' to deprecate in docs?
+<!-- What doc pages need to be created or updated across user, admin, and API docs?
+What concepts, procedures, or information is needed in each area? Is there an 'old way' to deprecate in docs?
Product managers:
-* By the kickoff, finalize the answers to the bullets above, and:
- * If applicable, specify new or updated feature name(s), description(s), benefits,
+* By the kickoff, finalize the answers to the bullets above, and also:
+ * When applicable, specify a new or updated feature name, description, benefits,
and use cases, which may all be used in the documentation or features.yml.
- * Specify which use cases or scenarios would benefit from a set of instructions
- or a guide unique to that use case. -->
+ * Specify which use cases or scenarios would benefit from a set of instructions or a guide,
+ whether unique to a single use case or flexible enough to cover multiple use cases. -->
### What does success look like, and how can we measure that?
-<!-- If no way to measure success, link to an issue that will implement a way to measure this -->
+<!-- Define both the success metrics and acceptance criteria. Note that success metrics indicate the desired business outcomes, while acceptance criteria indicate when the solution is working correctly. If there is no way to measure success, link to an issue that will implement a way to measure this. -->
### Links / references
-/label ~"feature proposal"
+/label ~feature