From 79577f4788446ce896489707e47dbfdbf061ed1a Mon Sep 17 00:00:00 2001 From: Matt Fisher Date: Tue, 19 Aug 2025 13:53:38 -0600 Subject: [PATCH 1/3] Add user story issue template --- .github/ISSUE_TEMPLATE/0-user-story.yml | 31 +++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/0-user-story.yml diff --git a/.github/ISSUE_TEMPLATE/0-user-story.yml b/.github/ISSUE_TEMPLATE/0-user-story.yml new file mode 100644 index 000000000..7a968f62c --- /dev/null +++ b/.github/ISSUE_TEMPLATE/0-user-story.yml @@ -0,0 +1,31 @@ +name: "📖 User story" +description: | + Share a workflow that you would like to see improve (faster, less + frustrating, less steps, and/or less cognitive load). +labels: + - "user story" +body: + - type: "textarea" + attributes: + label: "Description" + description: | + Please describe your experience clearly. + Please describe points of friction, frustration, or mental burden. + validations: + required: true + + - type: "textarea" + attributes: + label: "Steps" + description: | + Please write a numbered list of all the steps in your story. + Please write as if you're describing what a non-GIS-professional + looking over your shoulder would see. + + Please estimate the time consumed by each step. + + **We would especially like to know about where you experienced + [mental context switches](https://en.wikipedia.org/wiki/Human_multitasking) + during this process.** + validations: + required: true From 8bf251c6e21ae55613349c79063728e82d7d9f47 Mon Sep 17 00:00:00 2001 From: Matt Fisher Date: Tue, 19 Aug 2025 13:55:37 -0600 Subject: [PATCH 2/3] Add prompt to indicate which steps are frustrating or rewarding --- .github/ISSUE_TEMPLATE/0-user-story.yml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/0-user-story.yml b/.github/ISSUE_TEMPLATE/0-user-story.yml index 7a968f62c..db781cfe1 100644 --- a/.github/ISSUE_TEMPLATE/0-user-story.yml +++ b/.github/ISSUE_TEMPLATE/0-user-story.yml @@ -22,7 +22,8 @@ body: Please write as if you're describing what a non-GIS-professional looking over your shoulder would see. - Please estimate the time consumed by each step. + Please estimate the time consumed by each step, and let us know about + any steps that are particularly frustrating or rewarding. **We would especially like to know about where you experienced [mental context switches](https://en.wikipedia.org/wiki/Human_multitasking) From e29eec2928fbc45aa15f32c71fe6761d986ee27b Mon Sep 17 00:00:00 2001 From: Matt Fisher Date: Tue, 19 Aug 2025 17:02:34 -0600 Subject: [PATCH 3/3] Lint :bell: --- .github/ISSUE_TEMPLATE/0-user-story.yml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/0-user-story.yml b/.github/ISSUE_TEMPLATE/0-user-story.yml index db781cfe1..5b6e82032 100644 --- a/.github/ISSUE_TEMPLATE/0-user-story.yml +++ b/.github/ISSUE_TEMPLATE/0-user-story.yml @@ -1,22 +1,22 @@ -name: "📖 User story" +name: '📖 User story' description: | Share a workflow that you would like to see improve (faster, less frustrating, less steps, and/or less cognitive load). labels: - - "user story" + - 'user story' body: - - type: "textarea" + - type: 'textarea' attributes: - label: "Description" + label: 'Description' description: | Please describe your experience clearly. Please describe points of friction, frustration, or mental burden. validations: required: true - - type: "textarea" + - type: 'textarea' attributes: - label: "Steps" + label: 'Steps' description: | Please write a numbered list of all the steps in your story. Please write as if you're describing what a non-GIS-professional