From 38aef55b69ff9c82897a7bd37509b43255fd8d6b Mon Sep 17 00:00:00 2001 From: Mel Keene <133798521+mel-keene-gsa@users.noreply.github.com> Date: Tue, 12 Mar 2024 09:07:55 -0400 Subject: [PATCH 1/7] Update index.md changed Federalist link to cloud.gov pages changed Agile delivery link to go to the Agile guide changed Used-centered design link to go to the UX guide --- content/product/about-this-guide/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/product/about-this-guide/index.md b/content/product/about-this-guide/index.md index fdeb36dc..d94453a6 100644 --- a/content/product/about-this-guide/index.md +++ b/content/product/about-this-guide/index.md @@ -18,7 +18,7 @@ The 18F Product Guide is primarily written for consulting product managers at 18 ## How to use this guide -As a product manager at 18F, you may find yourself in a partner-facing consulting role to help a government agency build or buy a mission-critical product. As we work across the entire federal government and can now support state and local governments, you may encounter subject matter that is entirely new to you. Or, you may be working on one of TTS’ flagship products, like [Federalist](https://federalist.18f.gov/), [cloud.gov](https://cloud.gov/) or [login.gov](https://login.gov/). +As a product manager at 18F, you may find yourself in a partner-facing consulting role to help a government agency build or buy a mission-critical product. As we work across the entire federal government and can now support state and local governments, you may encounter subject matter that is entirely new to you. Or, you may be working on one of TTS’ flagship products, like [cloud.gov Pages](https://cloud.gov/pages), [cloud.gov](https://cloud.gov/) or [login.gov](https://login.gov/). In all cases, you will develop and steward a product vision and strategy, and drive a cross-functional team to deliver the right product to the right audience. This involves different activities and priorities at different phases of the work. Whether you're in discovery or implementation mode, you are creating the space and opportunity for your team to deliver on intended outcomes, rooted in empathy and evidence, that benefit members of the public and the government employees who serve them. @@ -36,9 +36,9 @@ This guide is divided into 4 sections: This guide and our approach to product management are informed by several frameworks that years of experience have shown to be effective in driving low-risk, successful technology projects in government: -- **[Agile delivery](https://derisking-guide.18f.gov/federal-field-guide/basic-principles/#agile-software-development)**: iteratively develop functional software, deploying and testing continuously. +- **[Agile delivery](https://agile.18f.gov/)**: iteratively develop functional software, deploying and testing continuously. -- **[User-centered design](https://derisking-guide.18f.gov/federal-field-guide/basic-principles/#user-centered-design)**: design with, not for the users of a system or government service. +- **[User-centered design](https://guides.18f.gov/ux-guide/)**: design with, not for the users of a system or government service. - **[Build and communicate in the open](https://18f.gsa.gov/2016/03/07/the-need-for-transparency-in-government/)**: build trust through transparency. From 3e5131b98227de0252ed63153e71858bcaa411b0 Mon Sep 17 00:00:00 2001 From: Mel Keene <133798521+mel-keene-gsa@users.noreply.github.com> Date: Tue, 12 Mar 2024 09:09:01 -0400 Subject: [PATCH 2/7] Update resources.md changed project catalogue to catalog --- content/product/about-this-guide/resources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/product/about-this-guide/resources.md b/content/product/about-this-guide/resources.md index b45217f1..026ea237 100644 --- a/content/product/about-this-guide/resources.md +++ b/content/product/about-this-guide/resources.md @@ -27,7 +27,7 @@ In addition to the resources provided in each section, here are more general res - [18F / TTS Handbook](https://handbook.tts.gsa.gov/) - Getting started at TTS: Your first 90 days -- 18F Project Catalogue +- 18F Project Catalog - 18F Project Resources Library - [18F Methods](https://methods.18f.gov/) - [Checklist of requirements for federal government websites](https://digital.gov/resources/checklist-of-requirements-for-federal-digital-services/) From cd17fb1608ffbfc4ec6247831132a06665b5d6f5 Mon Sep 17 00:00:00 2001 From: Mel Keene <133798521+mel-keene-gsa@users.noreply.github.com> Date: Tue, 12 Mar 2024 09:15:31 -0400 Subject: [PATCH 3/7] Update users.md changed how to conduct user research [2] to go to the research section of the ux guide changed what is hcd to go to the ux guide, updated description accordingly --- content/product/discover/users.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/product/discover/users.md b/content/product/discover/users.md index 452667eb..36320bef 100644 --- a/content/product/discover/users.md +++ b/content/product/discover/users.md @@ -66,7 +66,7 @@ Your partners likely have an incomplete view of the current state or what their - [How to conduct user research [1]](https://methods.18f.gov/): 18F Methods provide instruction on several different research activities to consider, including [interviews](https://methods.18f.gov/stakeholder-and-user-interviews), [contextual inquiries](https://methods.18f.gov/contextual-inquiry), [heuristic evaluation](https://methods.18f.gov/heuristic-evaluation), and more. -- [How to conduct user research [2]](https://handbook.tts.gsa.gov/research-guidelines/): Guidelines on how research is done at TTS, including informing and getting consent, and managing Personally Identifiable Information (PII). +- [How to conduct user research [2]](https://guides.18f.gov/ux-guide/research/): Guidelines on how research is done at TTS, including informing and getting consent, and managing Personally Identifiable Information (PII). - [How to synthesize user research](https://methods.18f.gov/): 18F Methods provide instructions on several different ways to tell users’ stories, including [journey maps](https://methods.18f.gov/journey-mapping), [user scenarios](https://methods.18f.gov/user-scenarios), [storyboards](https://methods.18f.gov/storyboarding), and [task flow analysis](https://methods.18f.gov/decide/task-flow-analysis/). @@ -74,4 +74,4 @@ Your partners likely have an incomplete view of the current state or what their - [How to share user research](https://18f.gsa.gov/2018/02/06/getting-partners-on-board-with-research-findings/): How to present findings to your partner and allow room for reaching consensus before making recommendations. -- [What is human-centered design](https://docs.google.com/document/d/1njVM3rSV_1Tyd7emSK9gMnbv_vzi0Dhm9vhE7LiqLrs/edit): A one-pager introducing and defining human-centered design and explaining why it’s a good idea. +- [What is human-centered design](https://guides.18f.gov/ux-guide/): A guide introducing and defining human-centered design and explaining why it’s a good idea. From 5fa100e306ff68627faa2092690b5c8a368f203b Mon Sep 17 00:00:00 2001 From: Mel Keene <133798521+mel-keene-gsa@users.noreply.github.com> Date: Tue, 12 Mar 2024 09:18:36 -0400 Subject: [PATCH 4/7] Update capacity.md removed what are the responsibilities [2] which went to an access denied link --- content/product/partners/capacity.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/product/partners/capacity.md b/content/product/partners/capacity.md index 18db054f..200b35df 100644 --- a/content/product/partners/capacity.md +++ b/content/product/partners/capacity.md @@ -58,6 +58,4 @@ Developing strong product leadership and management capacity with your partners - [What are the responsibilities [1]](https://docs.google.com/document/d/1YJYFlUte6hbhSoDRRjdZEUZDwydn2XBfF1bywnNV7CE/edit): A case for dividing product management responsibilities into a strategic (i.e., supervisor) role and a tactical (i.e., manager) role. -- [What are the responsibilities [2]](https://docs.google.com/document/d/1HdUoKIuA8xj-lYC1h8BlIFUX5sOtUV_PrKAT90lLitg/edit#heading=h.kxj9srha1axg): An example differentiation of the key responsibilities of the tactical vs strategic product roles. - - [What is product management vs project management](https://www.mindtheproduct.com/product-management-not-responsible-project-management/): An explanation of how these are different roles that should be filled by different people. From 5de62fa17e246247c5b6ba48f88576def005c960 Mon Sep 17 00:00:00 2001 From: Mel Keene <133798521+mel-keene-gsa@users.noreply.github.com> Date: Tue, 12 Mar 2024 13:48:12 -0400 Subject: [PATCH 5/7] Update content/product/about-this-guide/index.md Co-authored-by: John Skiles Skinner --- content/product/about-this-guide/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/product/about-this-guide/index.md b/content/product/about-this-guide/index.md index d94453a6..d0d58faa 100644 --- a/content/product/about-this-guide/index.md +++ b/content/product/about-this-guide/index.md @@ -36,7 +36,7 @@ This guide is divided into 4 sections: This guide and our approach to product management are informed by several frameworks that years of experience have shown to be effective in driving low-risk, successful technology projects in government: -- **[Agile delivery](https://agile.18f.gov/)**: iteratively develop functional software, deploying and testing continuously. +- **[Agile delivery](https://guides.18f.gov/agile/)**: iteratively develop functional software, deploying and testing continuously. - **[User-centered design](https://guides.18f.gov/ux-guide/)**: design with, not for the users of a system or government service. From 1d4e8c2fdb7d237bbfa8629405cf7225234a2eba Mon Sep 17 00:00:00 2001 From: Mel Keene <133798521+mel-keene-gsa@users.noreply.github.com> Date: Tue, 12 Mar 2024 13:55:36 -0400 Subject: [PATCH 6/7] Update users.md changed title and description around the UX guide to better fit the content in the guide --- content/product/discover/users.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/product/discover/users.md b/content/product/discover/users.md index 36320bef..ecd10c56 100644 --- a/content/product/discover/users.md +++ b/content/product/discover/users.md @@ -74,4 +74,4 @@ Your partners likely have an incomplete view of the current state or what their - [How to share user research](https://18f.gsa.gov/2018/02/06/getting-partners-on-board-with-research-findings/): How to present findings to your partner and allow room for reaching consensus before making recommendations. -- [What is human-centered design](https://guides.18f.gov/ux-guide/): A guide introducing and defining human-centered design and explaining why it’s a good idea. +- [18F User Experience Design Guide](https://guides.18f.gov/ux-guide/): The 18F UX Guide is a starting point for UX design: doing it, discussing it, and ensuring it’s done to a consistent level of quality. From 31459a1a0b47e6290b9be34f0c1b29f677fc7b3a Mon Sep 17 00:00:00 2001 From: Mel Keene <133798521+mel-keene-gsa@users.noreply.github.com> Date: Tue, 12 Mar 2024 14:07:48 -0400 Subject: [PATCH 7/7] Update users.md updated how to conduct user research [2] description to be more 18f-centric as opposed to tts-centric and to better reflect the content available in the 18f guide --- content/product/discover/users.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/product/discover/users.md b/content/product/discover/users.md index ecd10c56..06ed1f11 100644 --- a/content/product/discover/users.md +++ b/content/product/discover/users.md @@ -66,7 +66,7 @@ Your partners likely have an incomplete view of the current state or what their - [How to conduct user research [1]](https://methods.18f.gov/): 18F Methods provide instruction on several different research activities to consider, including [interviews](https://methods.18f.gov/stakeholder-and-user-interviews), [contextual inquiries](https://methods.18f.gov/contextual-inquiry), [heuristic evaluation](https://methods.18f.gov/heuristic-evaluation), and more. -- [How to conduct user research [2]](https://guides.18f.gov/ux-guide/research/): Guidelines on how research is done at TTS, including informing and getting consent, and managing Personally Identifiable Information (PII). +- [How to conduct user research [2]](https://guides.18f.gov/ux-guide/research/): Guidelines on how research is done at 18F, from how to make a research plan to how to comply with the Paperwork Reduction Act (PRA), participant privacy, and research ethics. - [How to synthesize user research](https://methods.18f.gov/): 18F Methods provide instructions on several different ways to tell users’ stories, including [journey maps](https://methods.18f.gov/journey-mapping), [user scenarios](https://methods.18f.gov/user-scenarios), [storyboards](https://methods.18f.gov/storyboarding), and [task flow analysis](https://methods.18f.gov/decide/task-flow-analysis/).