From f34d5562af2dd38bb8bd0e9a3c7f7c86f8f99abf Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 11:01:26 -0400 Subject: [PATCH 01/23] Update meta data for values-and-principles.md Updated meta data --- content/ux-guide/our-approach/values-and-principles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/our-approach/values-and-principles.md b/content/ux-guide/our-approach/values-and-principles.md index 15e3f911..6524443e 100644 --- a/content/ux-guide/our-approach/values-and-principles.md +++ b/content/ux-guide/our-approach/values-and-principles.md @@ -1,6 +1,6 @@ --- title: Values and principles -description: "These are the fundamentals that guide our work as 18F user experience (UX) designers." +description: "Values and principles that guide 18F's UX design process, including collaboration, working iteratively, and learning from real people about their diverse needs." permalink: /ux-guide/our-approach/values-and-principles/ layout: layouts/page tags: ux-guide From b73c46ebb804392111726a89852e743da241aa3f Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 11:52:58 -0400 Subject: [PATCH 02/23] Update meta data in index.md --- content/ux-guide/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/index.md b/content/ux-guide/index.md index 19de792e..85b247cb 100644 --- a/content/ux-guide/index.md +++ b/content/ux-guide/index.md @@ -19,7 +19,7 @@ subnav: href: "#reusing-this-guide-in-other-organizations" - text: References href: "#references" -description: "How 18F user experience (UX) designers improve interactions between our government and the public" +description: "How user experience (UX) designers at 18F approach their work, from conducting research to building prototypes." --- 18F user experience (UX) designers join cross-functional teams to improve interactions between government agencies and the people they serve. The 18F UX Guide helps us get this job done. It’s a starting point for UX design at 18F: doing it, discussing it, and ensuring it’s done to a consistent level of quality. From 1893b39345972d4ddd4251282cef30b92d70357c Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 11:53:52 -0400 Subject: [PATCH 03/23] Update meta data in LICENSE.md --- content/ux-guide/LICENSE.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/ux-guide/LICENSE.md b/content/ux-guide/LICENSE.md index 894844c1..fd806c81 100644 --- a/content/ux-guide/LICENSE.md +++ b/content/ux-guide/LICENSE.md @@ -1,5 +1,6 @@ --- title: License +description: "18F's User Experience Guide is in the public domain, and waives copyright and related rights." permalink: /ux-guide/license/ layout: layouts/page tags: ux-guide From c990cd3eac4ae02d51377238f0372ff6414ce8f1 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 11:57:57 -0400 Subject: [PATCH 04/23] Update meta data in resources.md --- content/ux-guide/resources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/resources.md b/content/ux-guide/resources.md index f49835fa..68a37555 100644 --- a/content/ux-guide/resources.md +++ b/content/ux-guide/resources.md @@ -1,6 +1,6 @@ --- title: Resources -description: "Additional templates, checklists, presentations, and other resources that 18F user experience (UX) designers use." +description: "Templates, presentations, and checklists to use in a UX research and design process." permalink: /ux-guide/resources/ layout: layouts/page tags: ux-guide From 28df1ce4813f24ace602c33bb9de13d6b42078a4 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 11:58:32 -0400 Subject: [PATCH 05/23] Update meta data in index.md --- content/ux-guide/our-approach/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/our-approach/index.md b/content/ux-guide/our-approach/index.md index f7129e07..039c154a 100644 --- a/content/ux-guide/our-approach/index.md +++ b/content/ux-guide/our-approach/index.md @@ -1,6 +1,6 @@ --- title: Our approach -description: "Read about 18F's essential approach to our design practice." +description: "An introduction to 18F's UX design practice, including team values, definitions of design, and staying lean." permalink: /ux-guide/our-approach/ layout: layouts/page tags: ux-guide From 403b63323cd6ff7bda98f010fd0540b5c8715f6f Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:00:22 -0400 Subject: [PATCH 06/23] Update meta data in defining-design.md --- content/ux-guide/our-approach/defining-design.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/our-approach/defining-design.md b/content/ux-guide/our-approach/defining-design.md index 853ef494..ffaf00cc 100644 --- a/content/ux-guide/our-approach/defining-design.md +++ b/content/ux-guide/our-approach/defining-design.md @@ -1,6 +1,6 @@ --- title: Defining design -description: "18F user experience (UX) designers see design as a process of intentionally deciding, over and over, how interactions should work for users, based on research." +description: "18F defines design as a process of deciding, over and over, how interactions and systems should work for people, based on research." permalink: /ux-guide/our-approach/defining-design/ layout: layouts/page tags: ux-guide From 5d357dccaa52a239b543ec3af4ee76d59e86fc69 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:00:53 -0400 Subject: [PATCH 07/23] Update meta data in stay-lean.md --- content/ux-guide/our-approach/stay-lean.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/our-approach/stay-lean.md b/content/ux-guide/our-approach/stay-lean.md index e4d944f4..aa0a1dc2 100644 --- a/content/ux-guide/our-approach/stay-lean.md +++ b/content/ux-guide/our-approach/stay-lean.md @@ -1,6 +1,6 @@ --- title: Stay lean -description: "18F user experience (UX) designers take a collaborative, incremental, and outcome-focused approach to our work." +description: "The Lean UX process involves research in each phase of a project to support continuous learning." permalink: /ux-guide/our-approach/stay-lean/ layout: layouts/page tags: ux-guide From fb2f95e462c38c3286e535310af28d5f78bcc300 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:02:24 -0400 Subject: [PATCH 08/23] Update meta data in meet-people-where-they-are.md --- content/ux-guide/our-approach/meet-people-where-they-are.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/our-approach/meet-people-where-they-are.md b/content/ux-guide/our-approach/meet-people-where-they-are.md index fb1ce7e4..3abcc44d 100644 --- a/content/ux-guide/our-approach/meet-people-where-they-are.md +++ b/content/ux-guide/our-approach/meet-people-where-they-are.md @@ -1,6 +1,6 @@ --- title: Meet partners where they are -description: "18F user experience (UX) designers view government agency partners as co-creators, encouraging a more participatory and sustainable design process." +description: "18F's approach to bringing partners into the design process as co-creators." permalink: /ux-guide/our-approach/meet-partners-where-they-are/ layout: layouts/page tags: ux-guide From ee9930b6841260137198ddd69189e062d4029595 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:03:13 -0400 Subject: [PATCH 09/23] Update meta data in index.md --- content/ux-guide/research/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/research/index.md b/content/ux-guide/research/index.md index 893713d5..2c059784 100644 --- a/content/ux-guide/research/index.md +++ b/content/ux-guide/research/index.md @@ -1,6 +1,6 @@ --- title: Research -description: "Design research explores possibilities, tests assumptions, and reduces risk by actively and systematically engaging with the world." +description: "How to conduct ethical, inclusive, and unbiased research with people while protecting their Personally Identifiable Information (PII)." permalink: /ux-guide/research/ layout: layouts/page tags: ux-guide From b49c2adde506ccf07d5d15f06a6b4844018d0f38 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:06:30 -0400 Subject: [PATCH 10/23] Update meta data in clarify-the-basics.md --- content/ux-guide/research/clarify-the-basics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/research/clarify-the-basics.md b/content/ux-guide/research/clarify-the-basics.md index 0f08358b..c2462889 100644 --- a/content/ux-guide/research/clarify-the-basics.md +++ b/content/ux-guide/research/clarify-the-basics.md @@ -1,6 +1,6 @@ --- title: Clarify the basics -description: "All 18F teams commit to continuous design research in order to make better decisions informed by end user perspectives." +description: "The basics of conducting UX research, including making research collaborative, explanations of methods, and best practices." permalink: /ux-guide/research/clarify-the-basics/ layout: layouts/page tags: ux-guide From 1a4914d8df01c5ccabf54f29a719ee70c1567d8e Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:07:00 -0400 Subject: [PATCH 11/23] Update meta data in plan.md --- content/ux-guide/research/plan.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/research/plan.md b/content/ux-guide/research/plan.md index f170c40a..535e6b3f 100644 --- a/content/ux-guide/research/plan.md +++ b/content/ux-guide/research/plan.md @@ -1,6 +1,6 @@ --- title: Plan -description: "Planning helps 18F teams adapt our approaches to the real world and ensures everyone's time is respected throughout the research process." +description: "How to plan UX research, including writing a plan, recruiting participants, defining outcomes, involving partners, and documentation." permalink: /ux-guide/research/plan/ layout: layouts/page tags: ux-guide From 9c7a7e7985b0d8829950562167fd031beb552974 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:08:09 -0400 Subject: [PATCH 12/23] Update meta data in do.md --- content/ux-guide/research/do.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/research/do.md b/content/ux-guide/research/do.md index 0317b841..a8704119 100644 --- a/content/ux-guide/research/do.md +++ b/content/ux-guide/research/do.md @@ -1,6 +1,6 @@ --- title: Do -description: "After planning, doing research involves engaging with previously agreed upon knowledge, participants, and data." +description: "How to conduct UX research, from designing, rehearsing, and moderating research sessions to debriefing as a team." permalink: /ux-guide/research/do/ layout: layouts/page tags: ux-guide From 2e845baec0562bb2e49ca481eeb6901a53482142 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:08:44 -0400 Subject: [PATCH 13/23] Update meta data in make-research-actionable.md --- content/ux-guide/research/make-research-actionable.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/research/make-research-actionable.md b/content/ux-guide/research/make-research-actionable.md index c04bc49b..eb16ef86 100644 --- a/content/ux-guide/research/make-research-actionable.md +++ b/content/ux-guide/research/make-research-actionable.md @@ -1,6 +1,6 @@ --- title: Make research actionable -description: "Analysis, synthesis, and sharing helps 18F user experience (UX) designers reflect on the data we’ve collected and determine a course of action." +description: "How to make UX research actionable, such as how to turn data into insights and share those with others." permalink: /ux-guide/research/make-research-actionable/ layout: layouts/page tags: ux-guide From 84b712c94e6df112bbd4f547872534634931a4f3 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:09:28 -0400 Subject: [PATCH 14/23] Update meta data in legal.md --- content/ux-guide/research/legal.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/research/legal.md b/content/ux-guide/research/legal.md index 03a58fa1..5380f74d 100644 --- a/content/ux-guide/research/legal.md +++ b/content/ux-guide/research/legal.md @@ -1,6 +1,6 @@ --- title: Legal -description: "18F designs our research to account for The Antideficiency Act and The Paperwork Reduction Act of 1995 (PRA), among other laws." +description: "How 18F conducts qualitative research that complies with the Paperwork Reduction Act of 1995 (PRA)." permalink: /ux-guide/research/legal/ layout: layouts/page tags: ux-guide From 5362fa3e949d9e3353142290e7c4f169a31a4f46 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:10:01 -0400 Subject: [PATCH 15/23] Update meta data in privacy.md --- content/ux-guide/research/privacy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/research/privacy.md b/content/ux-guide/research/privacy.md index c5bc84d7..41a0bf18 100644 --- a/content/ux-guide/research/privacy.md +++ b/content/ux-guide/research/privacy.md @@ -1,6 +1,6 @@ --- title: Privacy -description: "18F’s research practices are grounded in building and maintaining trust with research participants, a large part of which is protecting their privacy." +description: "How 18F protects the Personally Identifiable Information (PII) of research participants, including collecting consent and storing participant information." permalink: /ux-guide/research/privacy/ layout: layouts/page tags: ux-guide From 6baf1b28a2a07b32d7c4eceb00f16cc5781cc87a Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:10:40 -0400 Subject: [PATCH 16/23] Update meta data in bias.md --- content/ux-guide/research/bias.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/research/bias.md b/content/ux-guide/research/bias.md index 380cd1ae..6a829a9c 100644 --- a/content/ux-guide/research/bias.md +++ b/content/ux-guide/research/bias.md @@ -1,6 +1,6 @@ --- title: Bias -description: "These are 18F's starting points for proactively engaging with bias in the user research process." +description: "Definitions of different types of bias and explanation of how 18F accounts for bias in research." permalink: /ux-guide/research/bias/ layout: layouts/page tags: ux-guide From 66425e5bc43dd0751d66b6946bdddc501d85a375 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:11:52 -0400 Subject: [PATCH 17/23] Update meta data in ethics.md --- content/ux-guide/research/ethics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/research/ethics.md b/content/ux-guide/research/ethics.md index 34180b63..4509cca7 100644 --- a/content/ux-guide/research/ethics.md +++ b/content/ux-guide/research/ethics.md @@ -1,6 +1,6 @@ --- title: Ethics -description: "The following ethical principles help guide 18F user experience (UX) designers through some of the choices that this work can present." +description: "Ethical considerations for UX research and design, and how to acknowledge your power and privilege as a designer." permalink: /ux-guide/research/ethics/ layout: layouts/page tags: ux-guide From 381eb4c942a8f1edb617a267b923532e08e9e98f Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:13:25 -0400 Subject: [PATCH 18/23] Update meta data in share-power.md --- content/ux-guide/research/share-power.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/research/share-power.md b/content/ux-guide/research/share-power.md index 8e170fd0..aec311f2 100644 --- a/content/ux-guide/research/share-power.md +++ b/content/ux-guide/research/share-power.md @@ -1,6 +1,6 @@ --- title: Power dynamics in research -description: "Power is the ability to influence a situation. It is relative to where you fit within a situation, culture, or system. Power is not good or bad, it's how it is used or distributed that determines its value." +description: "An overview of power dynamics in research, examples of formal and informal types of power, and methods for sharing and shifting power." permalink: /ux-guide/research/share-power/ layout: layouts/page tags: ux-guide From 6a3c5f98bcee463a44f52589055559ec21b8e63d Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:13:59 -0400 Subject: [PATCH 19/23] Update meta data in index.md --- content/ux-guide/design/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/design/index.md b/content/ux-guide/design/index.md index 68af5fa0..13ce5cd3 100644 --- a/content/ux-guide/design/index.md +++ b/content/ux-guide/design/index.md @@ -1,6 +1,6 @@ --- title: Design -description: "About prototypes and how they inform the work of 18F, as well as resources on web publishing platforms and design systems to help you get started." +description: "How 18F creates prototypes and uses them for communication." permalink: /ux-guide/design/ layout: layouts/page tags: ux-guide From 8fc955c102bad1ec262bb8646d5f827df451c698 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:14:25 -0400 Subject: [PATCH 20/23] Update meta data in build-a-prototype.md --- content/ux-guide/design/build-a-prototype.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/design/build-a-prototype.md b/content/ux-guide/design/build-a-prototype.md index d7b41cdf..9108083c 100644 --- a/content/ux-guide/design/build-a-prototype.md +++ b/content/ux-guide/design/build-a-prototype.md @@ -1,6 +1,6 @@ --- title: Build a prototype -description: "18F encourages building something that will help you answer your questions with the least investment." +description: "How to build a prototype, from a paper sketch to a static site in Cloud.gov Pages, and things to consider when designing one." permalink: /ux-guide/design/build-a-prototype/ layout: layouts/page tags: ux-guide From 23dd5c26a3a65c97308847f1eb7a02a9ce07f989 Mon Sep 17 00:00:00 2001 From: Allison Press <94010142+allisonpress@users.noreply.github.com> Date: Thu, 28 Mar 2024 12:14:51 -0400 Subject: [PATCH 21/23] Update meta data in use-a-design-system.md --- content/ux-guide/design/use-a-design-system.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ux-guide/design/use-a-design-system.md b/content/ux-guide/design/use-a-design-system.md index 78c1e179..c7e65141 100644 --- a/content/ux-guide/design/use-a-design-system.md +++ b/content/ux-guide/design/use-a-design-system.md @@ -1,6 +1,6 @@ --- title: Use a design system -description: "A design system can help your team prototype faster, scale, manage front-end design debt, and apply consistency across your applications." +description: "On the benefits of using a design system, with a brief introduction to the U.S. Web Design System." permalink: /ux-guide/design/use-a-design-system/ layout: layouts/page tags: ux-guide From f3a1c94242ef2b6520d911af58e949e33da53183 Mon Sep 17 00:00:00 2001 From: Neil Martinsen-Burrell Date: Fri, 29 Mar 2024 11:19:12 -0500 Subject: [PATCH 22/23] Ignore iframes to fix intermittent pa11y errors --- .pa11yci | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/.pa11yci b/.pa11yci index 1acd5152..214b105b 100644 --- a/.pa11yci +++ b/.pa11yci @@ -3,6 +3,8 @@ "concurrency": 1, "standard": "WCAG2AA", "runners": ["htmlcs"], - "hideElements": "div[style*='display: none;'], [data-pa11y-ignore], a[href*='/TODO/" + // ignore iframes because we don't use them and DAP inserts an iframe + // that causes intermittent pa11y errors + "hideElements": "iframe, div[style*='display: none;'], [data-pa11y-ignore], a[href*='/TODO/" } } From 6eee6bedcb481f93b48f4a65c5736c330ee97531 Mon Sep 17 00:00:00 2001 From: Neil Martinsen-Burrell Date: Fri, 29 Mar 2024 11:24:55 -0500 Subject: [PATCH 23/23] Fix pa11y configuration --- .pa11yci | 10 ---------- .pa11yci.js | 10 ++++++++++ 2 files changed, 10 insertions(+), 10 deletions(-) delete mode 100644 .pa11yci create mode 100644 .pa11yci.js diff --git a/.pa11yci b/.pa11yci deleted file mode 100644 index 214b105b..00000000 --- a/.pa11yci +++ /dev/null @@ -1,10 +0,0 @@ -{ - "defaults": { - "concurrency": 1, - "standard": "WCAG2AA", - "runners": ["htmlcs"], - // ignore iframes because we don't use them and DAP inserts an iframe - // that causes intermittent pa11y errors - "hideElements": "iframe, div[style*='display: none;'], [data-pa11y-ignore], a[href*='/TODO/" - } -} diff --git a/.pa11yci.js b/.pa11yci.js new file mode 100644 index 00000000..f2f30417 --- /dev/null +++ b/.pa11yci.js @@ -0,0 +1,10 @@ +module.exports = { + defaults: { + concurrency: 1, + standard: "WCAG2AA", + runners: ["htmlcs"], + // ignore iframes because we don't use them and DAP inserts an iframe + // that causes intermittent pa11y errors + hideElements: "iframe, div[style*='display: none;'], [data-pa11y-ignore], a[href*='/TODO/" + } +}