Merge branch 'main' into cms/news/2024/07/2024-07-10-18fs-engineering…

…-craft-practices-at-10

content/events/2020/05/2020-05-13-average-american-reader-needs-you-write.md

@@ -30,9 +30,7 @@ authors:
 
 # YouTube ID
 youtube_id:
-
 # Make it better ♥
-
 ---
 
 {{< youtube id="aOy9UzClmMA" title="The Average American Reader Needs You to Write (Even More) Clearly" >}}
@@ -45,9 +43,9 @@ When communicating with the public, we must change our assumptions about their a
 
 Over 50% of U.S. adults score below an international benchmark for literacy, with roughly 20% scoring at the very lowest levels. These adults span all demographics and are a part of your audience. Don’t assume they’re not.
 
-You must  communicate clearly with your audience. Keep it simple and convenient, and use plain language. Present the most important information you want to convey first. Get feedback from your readers on whether they understand the information you’re trying to convey.
+You must communicate clearly with your audience. Keep it simple and convenient, and use plain language. Present the most important information you want to convey first. Get feedback from your readers on whether they understand the information you’re trying to convey.
 
-{{< card-quote text="One of the most important things we know about writing is to have some idea of your audience and whom you might be writing for." cite="Dr. Meredith Larson, Department of Education" >}}
+{{< quote-block text="One of the most important things we know about writing is to have some idea of your audience and whom you might be writing for." cite="Dr. Meredith Larson, Department of Education" >}}
 
 ## Background
 
@@ -60,9 +58,11 @@ PIAAC is designed to assess adults in different countries over a broad range of
 PIAAC has four domains:
 
 ### 1. Literacy
+
 "Literacy is understanding, evaluating, using, and engaging with written text to participate in the society, to achieve one's goals, and to develop one's knowledge and potential." [PIAAC Literacy Domain Page](<https://nces.ed.gov/surveys/piaac/literacy.asp).
 
 ### 2. Numeracy
+
 "The ability to access, use, interpret, and communicate mathematical information and ideas, to engage in and manage mathematical demands of a range of situations in adult life." [PIAAC Numeracy Domain Page](https://nces.ed.gov/surveys/piaac/numeracy.asp).
 
 {{< note >}}
@@ -83,6 +83,7 @@ For Literacy and Numeracy, **Level 3** should be sufficient for participation in
 - **Level 5**: Integrate information across multiple dense texts; construct syntheses, ideas or points of view; or evaluate evidence based arguments.
 
 ### 3. Digital Problem Solving in Technology-Rich Environments
+
 "Using digital technology, communication tools, and networks to acquire and evaluate information, communicate with others, and perform practical tasks." [PIAAC Problem Solving in Technology-Rich Environments Domain Page](https://nces.ed.gov/surveys/piaac/problem-solving.asp).
 
 {{< note >}}
@@ -99,6 +100,7 @@ For Digital Problem Solving, **Level 2** should be sufficient for participation
 - **Level 3**: Navigating multiple pages to find a form, etc.
 
 ### 4. Reading Components
+
 “Focuses on elements of reading that are comparable across the range of languages in the participating countries: reading vocabulary, sentence comprehension, and basic passage comprehension.” [PIAAC Reading Components Domain Page](https://nces.ed.gov/surveys/piaac/reading-components.asp).
 
 ## How the United States ranks
@@ -112,6 +114,7 @@ One of the most important things to know about writing is to have some idea of y
 ### Demographics
 
 Are those scoring below a sufficient level ...
+
 - Old or young? **Answer**: No. Low skills are fairly evenly distributed across age groups.
 - Non-native speakers? **Answer**: No. We cannot assume it’s just a language issue.
 - Unemployed? **Answer**: No. Most (62%) are employed.
@@ -129,9 +132,9 @@ Are those scoring below a sufficient level ...
 
 ## Related Links
 
- - IES research on [adult basic skills](https://ies.ed.gov/topics/adultBasic.asp)
- - [PIAAC assessment](https://nces.ed.gov/surveys/piaac/current_results.asp) of adult skills
- - Georgia State University [Adult Literacy Research Center](https://education.gsu.edu/research-outreach/alrc/)
+- IES research on [adult basic skills](https://ies.ed.gov/topics/adultBasic.asp)
+- [PIAAC assessment](https://nces.ed.gov/surveys/piaac/current_results.asp) of adult skills
+- Georgia State University [Adult Literacy Research Center](https://education.gsu.edu/research-outreach/alrc/)
 
 ---
 

content/guides/dap/_index.md

@@ -38,26 +38,25 @@ layout: single
 # 2 -- highlighted
 # 10, 9, 8, 7, or 6 -- for the five items that appear in the white box on homepage; 10 is first or at the top, and 6 is fifth or last.
 weight: 9
-
 ---
 
 ## What is DAP?
 
 The Digital Analytics Program (DAP) helps federal agencies understand how the public finds, accesses, and uses government services online.
 
-The U.S. General Services Administration (GSA) provides DAP as a shared service, so all federal agencies can use DAP’s web analytics tools, training, and support at no cost. 
+The U.S. General Services Administration (GSA) provides DAP as a shared service, so all federal agencies can use DAP’s web analytics tools, training, and support at no cost.
 
 DAP uses Google Analytics 360 to measure traffic and engagement across thousands of federal government websites and apps, reporting analytics under a single federal-wide shared account. Google Analytics 360 is the paid, enterprise version of Google Analytics 4 (GA4).
 
 ## Why use DAP?
 
-For millions, access to digital services isn’t a luxury — it’s critical. And the public’s experiences using government websites to find unemployment support, file taxes, apply for student loans, or get assistance with housing, childcare, or food can dramatically affect how they feel about the federal government. 
+For millions, access to digital services isn’t a luxury — it’s critical. And the public’s experiences using government websites to find unemployment support, file taxes, apply for student loans, or get assistance with housing, childcare, or food can dramatically affect how they feel about the federal government.
 
 All federal agencies can use DAP to better understand user behavior and improve their public-facing websites and digital services, which will make it easier for the public to access the information and services that they count on each and every day.
 
 Additionally, [M-23-22, Delivering a Digital-First Public Experience](https://digital.gov/resources/delivering-digital-first-public-experience/) requires all federal executive branch agencies to use DAP:
 
-{{< card-quote text="Agencies are required to participate in GSA’s government-wide Digital Analytics Program (DAP). Participation in DAP does not preclude agencies from using other web analytics services." cite="M-23-22, Section III-A, Subsection 6" >}}
+{{< quote-block text="Agencies are required to participate in GSA’s government-wide Digital Analytics Program (DAP). Participation in DAP does not preclude agencies from using other web analytics services." cite="M-23-22, Section III-A, Subsection 6" >}}
 
 ## Learn more about DAP
 

content/guides/hcd/design-concepts/designed-things.md

@@ -16,7 +16,6 @@ Whatever opportunities your team identified, you will most likely design a produ
 
 The National Archives provides some useful guidelines for differentiating between product and service from the viewpoint of the participant (or client, in their wording):
 
-{{< card-quote text="One way to think of [products and services] is from the clients’ point of view. When a client asks “what can you make for me?” they are asking about products; when a client asks “what can you do for me?” they are asking about services. While a product is something that can be measured and counted, a service is less concrete and is the result of the application of skills and expertise towards an identified need." cite="[Defining Key Concepts: Products vs. Services](https://www.archives.gov/preservation/products/definitions/products-services.html), National Archives">}}
-
+{{< quote-block text="One way to think of [products and services] is from the clients’ point of view. When a client asks “what can you make for me?” they are asking about products; when a client asks “what can you do for me?” they are asking about services. While a product is something that can be measured and counted, a service is less concrete and is the result of the application of skills and expertise towards an identified need." cite="[Defining Key Concepts: Products vs. Services](https://www.archives.gov/preservation/products/definitions/products-services.html), National Archives">}}
 
 As you read through this section, consider your opportunities through the lens of “product versus service versus system.” Do some of them speak to being expressed as one of these designed things? Might some of their possible designed outcomes be a combination? Is it still unclear for some?

content/guides/hcd/discovery-concepts/plan.md

@@ -10,10 +10,9 @@ primary_image: hcd-discovery-concepts
 
 A project brief will provide direction and help pave the way for a smooth start. You may get your brief from a supervisor or other group, or you or others may develop your own brief, to identify what you want to study.
 
-
 ## Framing
 
-{{< card-quote text="Tighter framing directly correlates with a more meaningful, targeted solution." cite="Veterans Affairs (VA) Center for Innovation">}}
+{{< quote-block text="Tighter framing directly correlates with a more meaningful, targeted solution." cite="Veterans Affairs (VA) Center for Innovation">}}
 
 Take time to frame a guiding question that will become the foundation of your research. When the FDA sought to align their testing standard for facemasks with testing standards for the same product managed by another federal agency, the problem was initially framed as a technical negotiation between scientists. However, during a co-design session it became clear that comfort was a critical factor that was missing from both testing standards and needed to be included in the problem frame. This recognition of what was missing led to a family of problem frames that would take the effort in new directions:
 
@@ -23,7 +22,6 @@ Take time to frame a guiding question that will become the foundation of your re
 
 Select a question that is broad enough to encompass the full shape of the issue you want to research, but defined enough to keep your research focused and on-track.
 
-
 ## Why use the “How might we” phrase?
 
 In the design research process, a “How Might We” (HMW) question serves two purposes:
@@ -33,7 +31,6 @@ In the design research process, a “How Might We” (HMW) question serves two p
 
 Use these specific words as you frame your problem. ‘Might’ is open, something to play with. Compare this to ‘should,’ which adds undue pressure and narrows the research from the start. The word ‘we’ centers the work on the team.
 
-
 ## Organize your team
 
 Assign team members specific roles and responsibilities for HCD discovery, including:
@@ -44,12 +41,10 @@ Assign team members specific roles and responsibilities for HCD discovery, inclu
 - Logistics Coordinator, who schedules interviews, coordinates travel for site visits, manages supplies, etc.
 - A local contact, who supports on-site recruiting and logistics.
 
-
 ## Select your research strategy
 
 Discuss and select your methods for gathering qualitative data. The key research method for discovery is in-depth interviewing. Ideally, you will interview participants for an hour or more (if time allows) in a place where they feel comfortable (such as their home, workplace, or a coffee shop). Consider using additional research strategies to supplement in-depth interviews, such as spending time observing people in their world.
 
-
 ## Secure allies
 
 Enlist supporters after your team has selected a guiding question, but  before you recruit participants. To gain support, reach out to people in your network (in and out of your agency) who could have an interest in this research. By making others aware of the work ahead, you build consensus and goodwill around the project, which is key to moving the project forward.

content/guides/hcd/discovery-operations/reframing.md

@@ -12,15 +12,14 @@ At this point in your project, you’ve learned more about your problem or brief
 
 This is good news! Because field research requires resources, reframing your problem frame to a narrower focus can help preserve resources for high-return field research. Good desk research also prevents you and your team from going out into the field and performing exhausting original research, only to find that other people have already covered the ground you thought you discovered.
 
-{{< card-quote text="Framing a design problem or brief is often seen as a preliminary, even pro-forma part of developing solutions. But how we define a problem largely defines its solution, and typically design problems and solutions co-evolve. This iterative framing and reframing of problems is as much a design opportunity as finding solutions." cite="The Lab at OPM">}}
+{{< quote-block text="Framing a design problem or brief is often seen as a preliminary, even pro-forma part of developing solutions. But how we define a problem largely defines its solution, and typically design problems and solutions co-evolve. This iterative framing and reframing of problems is as much a design opportunity as finding solutions." cite="The Lab at OPM">}}
 
 In this way, effective problem framing helps to:
 
 - Avoid wasting resources on solving the wrong problems
 - Expand the range of possible solutions to any given problem
 - Maximize creative leverage and innovative potential of HCD
 
-
 ### Who, what, why, goal
 
 Clearly articulating the project frame is key to a successful project. Whether your project originates from your own work, or from a project brief from your leadership, it is essential to be able to answer each of these before moving on to the next phase of development:
@@ -32,17 +31,16 @@ Clearly articulating the project frame is key to a successful project. Whether y
 
 Work with your team to incorporate their feedback as you answer these questions. Ensure that your answers are precise, coherent and in plain language. This process can help you precisely communicate your idea to others.
 
-
 ### Problem frame statement
 
 How you articulate your problem will influence how you approach it, so it’s important to find the right words. Stating your problem in the best possible terms takes creativity and critical thinking.
 
-Using the phrase “How might we…” is one of the best ways to start a problem frame statement: 
+Using the phrase “How might we…” is one of the best ways to start a problem frame statement:
 
 - “How” is action-oriented
 - “Might” is full of open-ended potential
 - “We” is collaborative and inviting.
 
 {{< ring title="Try it out">}}
 Referencing these directions, the work done in Desk Research, and the Who, What, Why, and Goal frameworks, try writing your own project frame statement.
-{{< /ring >}}
+{{< /ring >}}

content/guides/hcd/introduction/approach.md

@@ -5,7 +5,7 @@ guide: hcd-introduction
 primary_image: hcd-guide-intro
 ---
 
-{{< card-quote text="What people say, and what people do, and what people say they do, are entirely different things." cite="Dr. Margaret Mead, Anthropologist">}}
+{{< quote-block text="What people say, and what people do, and what people say they do, are entirely different things." cite="Dr. Margaret Mead, Anthropologist">}}
 
 This famous quote by Dr. Margaret Mead is a central truth to the social sciences and processes that build on them. Human-centered design is grounded in empathy and understanding. It begins with observation and research. We hear from people in their own words, to gain an understanding of what they want, expect, and need from a system, product, or experience.
 
@@ -37,4 +37,4 @@ You’ll learn how your design solution is performing. You’ll get quantitative
 
 {{< note variant="alert" >}}
 The Measurement Guides are currently in development.
-{{< /note >}}
+{{< /note >}}