Skip to content

Commit

Permalink
Merge branch 'main' into nbaumgold-patch-1
Browse files Browse the repository at this point in the history
  • Loading branch information
ToniBonittoGSA authored Jul 29, 2024
2 parents 36e41a3 + 48b9e81 commit da9b52e
Show file tree
Hide file tree
Showing 39 changed files with 594 additions and 294 deletions.
39 changes: 32 additions & 7 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,52 @@
## Summary

Basic description of work done. Closes [#issue_no].
Basic description of work done.

### Preview
## Preview

[Link to Preview]()

<!--
⚠️ Significant visual changes require submitting previous design to wayback machine.
-->

### Solution
## Solution

### How To Test
Provide a summary of the solution this PR offers.

<!--
It can be helpful if we understand:
1. What the solution is,
2. Why this approach was chosen,
3. How you implemented the change, and
4. Possible limitations of this approach and alternate solution paths.
-->


## How To Test

1. First Step
2. Second Step
3. Third Step

---
<!--
For PRs that include dependency updates, uncomment this section and
include a list of the changed dependencies and version numbers.
-->

<!--
## Dependency updates
### Dev Checklist
| Dependency name | Previous version | New version |
| ---------------------------- | :--------------: | :---------: |
| [Updated dependency example] | [1.0.0] | [1.0.1] |
| [New dependency example] | -- | [3.0.1] |
| [Removed dependency example] | [2.10.2] | -- |
-->

<!--
Before opening this PR, make sure you’ve done whichever of these applies to you:
- [ ] Branch is up-to-date and includes latest from `main`
- [ ] PR has correct labels
- [ ] A11y testing (voice over testing, meets WCAG, run axe tools)
- [ ] Code is formatted properly
-->
10 changes: 10 additions & 0 deletions content/authors/emily-mcdonald/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
display_name: Emily McDonald
first_name: Emily
last_name: McDonald
# e.g. U.S. General Services Administration
agency_full_name: U.S. Food and Drug Administration
# Agency Acronym [e.g., GSA]
agency: FDA
slug: emily-mcdonald
---
10 changes: 10 additions & 0 deletions content/authors/merrybelle-guo/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
display_name: Merrybelle Guo
first_name: Merrybelle
last_name: Guo
# e.g. U.S. General Services Administration
agency_full_name: U.S. Food and Drug Administration
# Agency Acronym [e.g., GSA]
agency: FDA
slug: merrybelle-guo
---
2 changes: 1 addition & 1 deletion content/authors/rachel-mundstock/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ slug: rachel-mundstock
email: "[email protected]"

# Bio — keep it under 50 words
bio: "Rachel is the Information Specialist for GSA&#39;s DigitalGov Search. She helps power the search experience on over 1,500 government websites. Feel free to email her at [email protected] with any questions or check out DigitalGov Search for more information."
bio: ""

# Where can people learn more about your agency or program? Provide a full URL [e.g. 'https://www.example.gov/']
bio_url: ""
Expand Down
1 change: 0 additions & 1 deletion content/authors/shonna-evans-thompson

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ This talk is hosted by Search.gov and Digital.gov.

[**Search.gov**](https://search.gov/) is a plug-and-play search solution that federal agencies can use to provide a high-quality search experience to their site’s users. Search.gov is a service of the General Services Administration, supporting the search boxes on over 2,000 websites, across 30% of federal domains.

For more information about Search.gov, email [search@support.digitalgov.gov](mailto:search@support.digitalgov.gov), or call 202-969-7426.
For more information about Search.gov, email [search@gsa.gov](mailto:search@gsa.gov), or call 202-969-7426.

Questions about this event or future events? Send them to [[email protected]](mailto:[email protected]).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,6 @@ In this online event, we’ll provide a basic overview of Search.gov’s essenti

[**Search.gov**](https://search.gov/) is a service of the General Services Administration, supporting the search boxes on over 2,000 websites, across 30% of federal domains.

For more information about Search.gov, email [search@support.digitalgov.gov](mailto:search@support.digitalgov.gov), or call 202-969-7426.
For more information about Search.gov, email [search@gsa.gov](mailto:search@gsa.gov), or call 202-969-7426.

_Questions about this event or future events? Send them to [[email protected]](mailto:[email protected])._
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ slug: uswds-monthly-call-june-2024
event_platform: zoom

primary_image: 2024-uswds-monthly-call-june-title-card

youtube_id: yBCLyWO0yCo
---

{{< asset-static file="uswds-monthly-call-june-2024.pptx" label="View the slides (Powerpoint presentation, 3 MB, 33 slides)">}}
Expand Down
15 changes: 12 additions & 3 deletions content/guides/dap/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,10 +5,13 @@ deck: "A free analytics tool for measuring digital services in the federal gover
summary: "The Digital Analytics Program (DAP) offers advanced, easy web analytics for federal agencies."
guide: dap

# See all topics at https://digital.gov/topics
topics:
- analytics
- digital-service-delivery
- user-experience

# Redirects: Enter the paths of the old URLs that you want redirected to this page.
aliases:
- /guide/dap/
- /guides/dap/become-a-dap-certified-analyst/
Expand All @@ -22,14 +25,20 @@ aliases:
- /guides/dap/gaining-access-to-dap-data/
- /guides/dap/guidelines-for-sharing-dap-data/

image: guide-dap

# For social media shares; if not provided, the default Digital.gov logo card appears.
primary_image: guide-dap

weight: 1
guide_weight: 5
image: guide-dap
layout: single

# Controls how this page appears across the site
# 0 -- hidden
# 1 -- visible
# 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?
Expand Down
25 changes: 21 additions & 4 deletions content/guides/site-scanning/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,13 @@ date: 2020-06-25 09:00:00 -0500
title: "Understanding the Site Scanning program"
deck: "A set of daily scans of the federal web presence."
summary: "This program is available to automatically generate data about the health and best practices of federal websites."

guide: site-scanning
image: guide-site-scanning
layout: single
guide_weight: 3

# Redirects: Enter the paths of the old URLs that you want redirected to this page.
aliases:
- /guide/site-scanning/
- /site-scanning/
Expand All @@ -12,11 +18,22 @@ aliases:
- /sitescan/
- /site-scans/
- /sitescans/
image: guide-site-scanning

# See all topics at https://digital.gov/topics
topics:
- analytics
- budgeting-and-performance

# For social media shares; if not provided, the default Digital.gov logo card appears.
primary_image: guide-site-scanning
layout: single
weight: 8
guide_weight: 3

# Controls how this page appears across the site
# 0 -- hidden
# 1 -- visible
# 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: 2

---

**The Site Scanning program** automates a wide range of scans of public federal websites and generates data about website health, policy compliance, and best practices.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ While this series of posts will discuss the requirements above separately, the b
2. Build our servers and application within AWS
3. Cut over our read-only data center, allow dust to settle; then cut over our read-write data center, allow dust to settle; shut off old infrastructure

If you have questions or would like to discuss particulars, [we would love to hear from you](mailto:search@support.digitalgov.gov).
If you have questions or would like to discuss particulars, [we would love to hear from you](mailto:search@gsa.gov).

<h3 id="series">
<em>This is the first post in a five part series. Stay tuned for the following posts:</em>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,9 @@ And finally, do you have a formal method of evaluating the search experience tha

Best,

UX Vexed {{< legacy-img src="2016/08/600-x-400-Search-bar-on-virtual-screen-Gajus-iStock-Thinkstock-178761722.jpg" alt="Search bar on virtual screen." caption="" >}}
UX Vexed

{{< legacy-img src="2016/08/600-x-400-Search-bar-on-virtual-screen-Gajus-iStock-Thinkstock-178761722.jpg" alt="Search bar on virtual screen." caption="Gajus/iStock/Thinkstock" >}}

Dear Vexed,

Expand All @@ -45,24 +47,23 @@ There is a line of thinking that says if a site is designed optimally, then <a h

<a href="https://search.gov" target="_blank">DigitalGov Search</a>, like any search tool worth its salt, provides robust search analytics. We give views into to the top <a href="http://search.digitalgov.gov/manual/queries.html" target="_blank">queries</a> your site gets and the <a href="http://search.digitalgov.gov/manual/clicks.html" target="_blank">top pages clicked on</a> out of your results pages. We also provide click-through rates for all queries: for all the times a query was run, how many clicks did that search results page get? You can see this for the top queries, or you can search for a particular term and see all the queries that contain that term.

{{< legacy-img src="2016/09/Queries\_-\_USA_gov-600w.png" alt="Screenshot of DigitalGov Search report on the top queries performed on USA.gov" >}}
{{< legacy-img src="2016/09/Queries_-_USA_gov-600w.png" alt="Screenshot of DigitalGov Search report on the top queries performed on USA.gov" >}}

A really low click-through rate, or one well above 100%, is a sign that some sort of change would be helpful to searchers, but what that change is will depend on what they were looking for.

Does a particular page need to be boosted in the search results, or do you need to respond to queries on a jargony keyword? Then <a href="http://search.digitalgov.gov/manual/best-bets.html" target="_blank">setting up a Best Bet</a> in our Admin Center may be your answer. Or does the page need a plain language rewrite? A click-through rate over 100% means that searchers are, on average, clicking on the same results page a bunch of times, finding results that look promising, but then the content doesn’t end up serving their needs. This kind of bouncing is called <a href="https://www.nngroup.com/articles/pogo-sticking/" target="_blank">pogo sticking</a> &#8211; fun for kids, frustrating for searchers. It could indicate your site has a lot of similar-looking content on a given topic that could benefit from disambiguating the page titles.

The next important question is: Where were the searchers when they ran a particular query? I’ve seen cases where a query was run directly from a page that, from the look of the url, should have contained the information the person was looking for. In our <a href="http://search.digitalgov.gov/manual/referrers.html" target="_blank">referrers</a> report you can see the pages where the most queries were run on your site, and from there you can see all the queries that were run on any particular page. This is a gold mine for determining whether it’s your search configuration or your site content &#8211; or structure! &#8211; that needs tweaking.

{{< legacy-img src="2016/09/Referrers\_-\_USA_gov-600w.png" alt="The DigitalGov Search Top Referring URLs report, showing the pages on which people most frequently used the search box." >}}
{{< legacy-img src="2016/09/Referrers_-_USA_gov-600w.png" alt="The DigitalGov Search Top Referring URLs report, showing the pages on which people most frequently used the search box." >}}

Because the relationships between all these data points can be complex, we gave a webinar in December 2015 on analytics. Michelle Chronister, the former user experience team lead for USAgov, described how that team looks at search data for trends that can guide USAgov’s content strategy. They group query terms into topics, and analyze at the topic level. A <a href="{{< ref "2016-01-08-what-are-your-customers-searching-for.md" >}}" target="_blank">webinar recap</a> is available that includes a video recording, slide deck, and data tracking/report template as well as an infographic of USAgov’s 2015 search traffic.
Because the relationships between all these data points can be complex, we gave a webinar in December 2015 on analytics. Michelle Chronister, the former user experience team lead for USAgov, described how that team looks at search data for trends that can guide USAgov’s content strategy. They group query terms into topics, and analyze at the topic level. A <a href="https://digital.gov/2016/01/08/what-are-your-customers-searching-for/>">webinar recap</a> is available that includes a video recording, slide deck, and data tracking/report template as well as an infographic of USAgov’s 2015 search traffic.

By looking at trends for individual queries, query topics, locations, and destinations, you’ve begun the journey towards using data to better inform your search configuration and content strategy. We also recommend looking at your website data from the <a href="{{< ref "/guides/dap/_index.md" >}}" target="_blank">Digital Analytics Program</a> or any other analytics software you have running on your site.
By looking at trends for individual queries, query topics, locations, and destinations, you’ve begun the journey towards using data to better inform your search configuration and content strategy. We also recommend looking at your website data from the <a href="https://digital.gov/guides/dap/">Digital Analytics Program</a> or any other analytics software you have running on your site.

If you have further questions, Vexed, you can always [email the DigitalGov Search team](mailto:search@support.digitalgov.gov).
If you have further questions, Vexed, you can always [email the DigitalGov Search team](mailto:search@gsa.gov).

Happy searching,

Dawn

Dawn <br />
Program Manager, DigitalGov Search
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
# Originally published at the following URL
source_url: https://blog.usa.gov/designing-for-people-with-disabilities
source: usagov
date: 2024-07-16
title: "Designing for people with disabilities"
deck: "The User Experience (UX) team at USA.gov's Public Experience Portfolio recently conducted a study to analyze the experiences of individuals who access USA.gov through assistive technology. The team partnered with a local organization to gather insights from a diverse group of participants, many of whom are blind or deaf. The study revealed various habits and challenges faced by these users, such as a preference for mobile sites, difficulty with website carousels, and a reliance on clear headings and action-oriented descriptions. These findings can guide improvements in accessibility, such as clever link labeling and better navigation aids for assistive technology users."
summary: "The User Experience (UX) team at USA.gov's Public Experience Portfolio recently conducted a study to analyze the experiences of individuals who access USA.gov through assistive technology. The team partnered with a local organization to gather insights from a diverse group of participants, many of whom are blind or deaf. The study revealed various habits and challenges faced by these users, such as a preference for mobile sites, difficulty with website carousels, and a reliance on clear headings and action-oriented descriptions. These findings can guide improvements in accessibility, such as clever link labeling and better navigation aids for assistive technology users."
# See all topics at https://digital.gov/topics
topics:
- accessibility
- content-strategy
- human-centered-design
- information-collection
- best-practices
- user-centered-design
- usability
slug: designing-for-people-with-disabilities
# Controls how this page appears across the site
# 0 -- hidden
# 1 -- visible
weight: 1
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
# Originally published at the following URL
source_url: https://blog-nrrd.doi.gov/work-priorities/
source: doi-revenuedata
date: 2024-07-23
title: "Reassessing priorities: Adapting to additional work without additional resources"
deck: "The Office of Natural Resources Revenue’s Open Data, Design, and Development (ODD) team is taking on management of a fourth website, despite being short-staffed. As a result, they have revisited and reprioritized their yearly goals. To do so, they utilized a prioritization matrix, developed a structured impact assessment, and laid out a transition plan. Their process ensured realistic workload adjustments, improved team morale, and highlighted the importance of practical goal-setting, especially when teams are short-staffed."
summary: "The Office of Natural Resources Revenue’s Open Data, Design, and Development (ODD) team is taking on management of a fourth website, despite being short-staffed. As a result, they have revisited and reprioritized their yearly goals. To do so, they utilized a prioritization matrix, developed a structured impact assessment, and laid out a transition plan. Their process ensured realistic workload adjustments, improved team morale, and highlighted the importance of practical goal-setting, especially when teams are short-staffed."
# See all topics at https://digital.gov/topics
topics:
- best-practices
- communication
- product-and-project-management
- content-strategy
- data-visualization
- innovation
slug: reassessing-priorities-adapting-to-additional-work-without-additional-resources
# Controls how this page appears across the site
# 0 -- hidden
# 1 -- visible
weight: 1
---
3 changes: 2 additions & 1 deletion content/resources/an-introduction-to-digital-governance.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,8 @@ topics:
# 0 -- hidden
# 1 -- visible
# 2 -- highlighted
weight: 5
weight: 6


slug: an-introduction-to-digital-governance

Expand Down
3 changes: 2 additions & 1 deletion content/resources/an-introduction-to-domain-management.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,8 @@ topics:
# 0 -- hidden
# 1 -- visible
# 2 -- highlighted
weight: 6
weight: 8


slug: an-introduction-to-domain-management

Expand Down
4 changes: 3 additions & 1 deletion content/resources/an-introduction-to-search.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,13 @@ summary: Learn why search functionality is an important component of federal
topics:
- digital-service-delivery
- search-engine-optimization

# Controls how this page appears across the site
# 0 -- hidden
# 1 -- visible
# 2 -- highlighted
weight: 6
weight: 7

slug: an-introduction-to-search

---
Expand Down
Loading

0 comments on commit da9b52e

Please sign in to comment.