Skip to content

Create a Guide/Template: Glossary #54

Open
@daniellex0

Description

@daniellex0

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.

Resources/Instructions

External Resources

Internal Resources

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

Checked the following and found no results

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

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
  • 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.
  • 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