ux-guide
ux-guide copied to clipboard
18F
Update meta description
Background The current meta description that appears when people link in Slack and on social to any UX Guide page: "This is the beginning of a guide that will house resources, norms, and practices for doing user experience research and design work at 18F."
Acceptance criteria
- [ ] There are page-specific meta descriptions for all pages of the Guide
Definition of done
- [ ] One of the POs has approved the change
I wonder if the Guides team has any suggestions / guidance re themes to cover in the meta description (and possibly for updating the initial paragraph on the landing page, which is very 18F-audience focused).
This spreadsheet is a good place to start with content for meta descriptions. It links to the original guide pages which include goals for each page
I need to correct (or clarify?) myself from yesterday's conversation.
I said we could update a value in the guide config file and be done. That is only true if it's okay for every page in the guide to have the same meta description. If each page should have its own unique meta description, then they will all need to be updated to include a description key in the frontmatter. It's more engineering work than I said yesterday, though provided the content, it should still be pretty low. Hours instead of minutes, maybe?
Thanks for checking on the LOE on this issue @mgwalker. I removed the "help wanted: brief" tag from the issue.
Each page should have a unique meta description. @echappen let me know if you'd like to cowork on the content. I'm happy to do so.
Here is a draft for the overview page meta description "The 18F UX Guide contains useful guidance for federal designers conducting user experience or human centered design and is a general reference that anyone can use."
The rest of the pages might start with "This 18F UX Guide page enables readers to... [short goal statement from the spreadsheet]."