Create Wiki Glossary Draft: CTJ

[kcoronel]

Overview

We need to create a Civic Tech Jobs Glossary and sync it with the Hack for LA Glossary so that we can make it accessible to team members and website visitors without duplicating terms.

Action Items

• Gather all previous glossary-style documentation (e.g. spreadsheets, docs, wikis, issue comments) and add to Resources below
• Open the guide and follow instructions...
  • Review pre-work material
    • Read "What is in the Create a Project Glossary Guide"
    • Read "Alternatives or Things to Know?"
    • Confirm you have "Prerequisites For Using This Guide
      • Access to the HfLA: Glossary
      • Access to the [PROJECT NAME]: Wiki Glossary Draft Template
      • A Google Drive for your project and a place to put the template
    • Read "What is Google Sheets?"
    • Read "How to Use This Guide"
      • follow instructions if you do not have edit access to prerequisites
  • Set up the glossary draft for your project...
    • Step 1: Check For a Preexisting Project Glossary
    • Step 2: Review The Preexisting Project Glossary
      • continue following this guide to ensure your preexisting glossary matches org requirements
    • Step 3: Copy the Template
  • add the newly created wiki glossary draft and add to Resources
  • Template Instructions
    • Step 1: Update Your Project Information
      • switch to sheet: "Project Glossary (input)"
      • replace [TEAM LOGO] with an image of your team's logo
        • pls grab logo from Figma or Google Drive... no screenshots...
      • replace [Project Name] with your team's name
    • Step 2: Input Terms
      • Review any/all previous glossary-style documentation for your project
        • e.g. issues, google docs/sheets/slides, Figma
      • switch to sheet: "Project Glossary (input)"
      • Add any missing terms into sheet
    • Step 3: Review
      • switch to sheet: "Glossary-All terms (HfLA & Project)
      • review all terms
      • delete any duplicate terms (highlighted in red)
    • Step 4: Submit for Approval
      • switch to sheet: "Project Glossary (input)
      • get sign off by project lead
      • project lead to use "Peer Reviewer Questions and Feedback" and "Final" column for approval
    • Step 5: Update Guides Team:
      • Post in admin channel (see instructions in guide for message contents)
• Wrap up and next steps
  • Decide where links to the HfLA + Project Glossary should live (e.g. Wiki, Website, onboarding items)
  • Brainstorm an approach for adding new terms to the Project Glossary
    • add all draft glossary terms in a new comment

Resources/Instructions

• Reference Material: 📝 Google Doc: How To: Create A Project Glossary
• Deliverable: 📊 Google Sheet: ⚠️ project-name: Wiki Glossary Draft
  • 📂 Google Drive Path: ⚠️ link-to-drive-folder
• Other ⚠️ project-name Related Links
  • add links that are useful for glossary population here...

https://docs.google.com/spreadsheets/d/1MHJejLfVClQzGemRSEqPUjaff_vPQ9OODY3NEW2bXso/edit?usp=sharing