EPIC: Updates to the architecture and content of the UX Guide

[claireb-gsa]

Making improvements to the organization and content of the UX guide.

Background

This effort got started as a part of updating the resources page content. It became clear that in looking at templates, we also needed to update the site content that related to them.

Effort details are being captured in README: TLC 2024 UX guide update (GSA only)

Issues this work should address

In support of [EPIC] As a site visitor, I'd like the information in the UX guide to reflect up-to-date practices #384

• Imbalance of content between Research and Design (research holds the bulk of the content)
• Vague page titles that are difficult to understand in search results (Plan, do)
• Inconsistent labeling of guide resources Make UX Guide "resource" titles consistent and easy to recognize in search results  #402

Related past work

• Past work: 🔴 Making content consistent in the ux guide 🔴 Making content consistent in the ux guide  #285

Point of contact on this issue

@claireb-gsa

Reproduction steps (if necessary)

No response

Skills Needed

- Any Human, Design Content

Does this need to happen in the next 2 weeks?

No

How much time do you anticipate this work taking?

weeks?

Acceptance Criteria

• Proposed architecture is in place
• Content edits are complete

Sub-Epics

Preview Give feedback

1. Content and structure updates to UX Guide Research section #584
   0 of 7
   Guides Initiative 2 UX blocked pair +5
   
2. IA changes to UX guide Research section #589
   0 of 1
   Guides Initiative 2 UX blocked +4
3. Create content and copy guidelines for the UX guide #585
   2 of 6
   Guides Initiative 2 UX blocked +4
   
4. Move and organize the UX Guide Resources #583
   0 of 6
   Guides Initiative 2 UX blocked +4

Related tickets

Preview Give feedback

1. Make UX Guide "resource" titles consistent and easy to recognize in search results #402
   Guides Initiative 2 UX +3
   
2. Combine three interview templates (guide, debrief, checklist) into a single template #603
   Guides Initiative 2 +2
   
3. Update UX Guide Research Plan Resource #549
   6 of 6
   Guides Initiative 2 UX +3
   
4. https://github.com/18F/TLC-crew/issues/831

[bpdesigns]

Moving to in progress as it relates to work that @claireb-gsa is already doing

[bpdesigns]

@claireb-gsa this work is approved and prioritized.

[claireb-gsa]

for lack of emoji... :happy-dance:!

[claireb-gsa]

As I roll off TLC, a quick update on this work from my perspective:

Work is ongoing to define audience and goals for the UX guides and methods, which will inform the other work that needs to happen:

• updating the content on the UX guide, especially the research section, to make it more readable, usable, and reflective of our current practices
• based on the new content, updating the navigation to make content more findable