From dc89143faa4cfbad7e62c161ac57db022282d2c7 Mon Sep 17 00:00:00 2001 From: Sheng Yang Date: Thu, 19 Mar 2020 12:52:17 -0700 Subject: [PATCH] Update YYYYMMDD-template.md Signed-off-by: Sheng Yang --- enhancements/YYYYMMDD-template.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/enhancements/YYYYMMDD-template.md b/enhancements/YYYYMMDD-template.md index 1852ef7..37e3cd2 100644 --- a/enhancements/YYYYMMDD-template.md +++ b/enhancements/YYYYMMDD-template.md @@ -28,15 +28,17 @@ What is out of scope for this enhancement? Listing non-goals helps to focus disc This is where we get down to the nitty gritty of what the proposal actually is. -### User Stories [optional] -Detail the things that people will be able to do if this enhancement is implemented. Include as much detail as possible so that people can understand the "how" of the system. The goal here is to make this feel real for users without getting bogged down. +### User Stories +Detail the things that people will be able to do if this enhancement is implemented. A good practise is including a comparsion of what user cannot do before the enhancement implemented, why user would want an enhancement and what user need to do after, to make it clear why the enhancement beneficial to the user. + +The experience details should be in the `User Experience In Detail` later. #### Story 1 #### Story 2 -### User experience description +### User Experience In Detail -Detail what user need to do to use this enhancement. +Detail what user need to do to use this enhancement. Include as much detail as possible so that people can understand the "how" of the system. The goal here is to make this feel real for users without getting bogged down. ## Design