Description
Overview
We need to create a guide for a UX Researcher's Glossary so that new UX Researchers at Hack for LA can quickly become familiar with the most common terminology
Action Items
The phases in the guide-making process are listed below. Each phase displayed in blue is linked to a wiki page with instructions on how to complete that phase. Open the wiki page in a new tab, copy the instructions for each part into the section labeled 'Tasks' at the bottom of this issue, and complete each task listed.
- Gather Examples Solo (open in a new tab)
- Gather Examples Collaboratively
- Create a Guide Draft
- If needed, create a template
- Have your guide peer reviewed
- Present your guide for leadership review
Resources/Instructions
- Google Drive Folder for this Guide’s documents and shortcuts (to documents in other locations) 0054[DRAFT] Glossary
- DRAFT Guide: Guide: Create a Glossary
- DRAFT Template: [PROJECT NAME]: Wiki Glossary Draft - Tabs:
- DRAFT HfLA: Glossary Tabs:
- Bonnie's comment about how glossary making should be done at HfLA (this will be the starting point for the instructions in the guide
External Resources
- Usability.gov UX Research glossary
- UX Glossary
- Common HfLA terminology: Guides: Glossary draft
Internal Resources
- Guide: UX Researcher Toolkit
- has been deleted
Phase 1 findings
Current glossaries
Name | Format |
---|---|
Access the Data | GitHub Wiki |
Civic Tech Index | GitHub Wiki |
Expunge-Assist | Google Doc |
Food Oasis | Google Sheet |
Guides | GitHub Wiki, Google Sheet |
HomeUniteUs | GitHub Wiki, Google Sheet |
Tech Work Exp. | Google Sheet |
TDM Calculator | Google Sheet |
Product | Google Sheet |
GitHub Wiki
Pros:
- Lives within the project's repository
- Integrates with other knowledge content as a Wiki
Cons:
- Requires knowledge of GitHub and Markdown
- Collaboration requires git, fork, PR, etc.
Google Sheet/Doc
Pros:
- Easier to setup, edit, and share
- Simple collaboration tools
Cons:
- Lives outside the project's repository
- Can be misplaced and/or duplicated as members change
- (Doc) Not ideal for large glossaries and table formats
Projects to Check
- Access the Data
- Civic Tech Index - on hold
- Expunge-Assist (formerly known as Record Clearance)
- Food Oasis
- Guides
- HomeUniteUs
- Wiki
- Slack example
Google Sheets glossaryHas been deleted
- Tech Work Experience (Internship project)
- TDM Calculator
- Product
Checked the following and found no results
- 100 Automations - on hold
- 311 Data
- BallotNav - on hold
- Brigade Organizer's Playbook
- Civic Tech Jobs
- Design Systems
- Engage - on hold
- GreenEarthOS - on hold
- Lucky Parking
- Open Community Survey - on hold
- People Depot
- Tables team
- VRMS
- Hack for LA's Website
- Youth Justice Nav - on hold
- Data Science Projects
- UI/UX
- Dev Ops
- Engineering
Tasks
Use this deck Part 3: Connecting with Other Teams & Moving the Conversation Forward
Remove the following labels from your issue as you complete them:
- status: needs communication with teams
Congrats you have completed Part 2: Gathering Examples with Slack
- Go to Making Example Issues + Last Check with Admin and copy the next steps, into the next comment.
Completed
-
Gathering Examples with GitHub
Follow the instructions from the slide deck Part 1: Gathering Examples With GitHub: Wiki, Issues, Project Board, Resources Provided- Remove the following labels from your issue as you complete them:
- status: needs wiki examples
- status: needs issues examples
- status: needs project board examples
- Congrats you have completed Part 1: Gathering Examples With GitHub: Wiki, Issues, Project Board, Resources Provided
- Go to Gather Examples, Use GitHub Search and copy the the text block (next steps), below this line
- Remove the following labels from your issue as you complete them:
-
Gathering Examples with Github Search
Follow the instructions from the slide deck Part 1.5: How to Use Github Search- Complete the activities inside the deck
- Congrats! You have completed part 1.5: How to Use Github Search.
- Go to Gather Examples with Slack and copy it below
-
Gathering Examples with Slack
Follow the instructions from the slide deck Part 2: Gathering Examples With Slack- Remove the following labels from your issue as you complete them:
- status: needs slack examples
- Phase: 1 - Gather Examples Solo
- Congrats! You have completed Part 2: Gathering Examples with Slack
- Go to Phase 2 - Gather Examples Collaboratively and copy and copy it below
- Remove the following labels from your issue as you complete them:
Metadata
Metadata
Assignees
Labels
Type
Projects
Status
Status