Create a Guide: Communication (style) Guide for Document Creation template/examples

[ExperimentsInHonesty]

Overview

We need to create a guide to making a Communication (style) Guide for Document Creation so that the documents that come out of their projects will have a consistent look and feel that has been coordinated with HfLA org leadership to maintain brand consistency both in their project and with other projects in the portfolio.

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 labelled '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

Projects to Check

• 100 Automations
  • Issues
    • Communication (style) Guide for Document Creation 100Automations/Website#138
  • WIKI
    • Instructions for how to make a guide on their website: https://github.com/100Automations/Website/wiki/Guide-to-the-Guide-Template
    • template for making a guide on their website: https://github.com/100Automations/Website/wiki/guide_template.md
• 311 Data
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Access the Data
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• BallotNav
  • Issues BallotNav Communications Guide ballotnav#435
  • Communication Guide
• Civic Tech Index
  • Issues
    • CTI Communication (style) Guide for Document Creation template/examples civictechindex/CTI-website-frontend#711
• Civic Tech Jobs
  • Issues
    • Create a CTJ Communications guide CivicTechJobs#152
• Civic Tech Structure
  • Copy
• Data Science Projects
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Design Systems
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Engage
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Expunge Assist
  • Communication Guide
• Food Oasis
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• GreenEarthOS
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Guides
  • Issue Update One Sheet: Write for All product-management#60
  • Doc 1
  • Doc 2
• HomeUniteUs
  • Issues
    • Create Communication Style Guide. HomeUniteUs#315
• Internship
  • Communications Guide - WIP
• Lucky Parking
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Open Community Survey
  • Communication Guide - mostly done and a good example
• People Depot
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• TDM Calculator
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• VRMS
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Hack for LA's Website
  • None as of 2021-09-1
• Youth Justice Nav
  • Issues
  • Update Communication guide YouthJusticeNav#63

External projects (with finished communication guides)

BOP Communications Guide for Document Creation
Copy of Get Your Refund Communications Guide for Document Creation

Communities of Practice

• UI/UX community of practice
  • None as of 2021-09-1

Tasks

• This is where you will copy instructions from the wiki page for the step you are currently on.

[aymarmsba]

Prior version of issue

Overview

We need to create a guide to making a Communication (style) Guide for Document Creation so that the documents that come out of their projects will have a consistent look and feel that has been coordinated with HfLA org leadership to maintain brand consistency both in their project and with other projects in the portfolio.

Action Items

• Gather examples of how other Hack for LA projects have done, adding each example below.
  • We have made the issues for you to post when you do outreach to the project leads. Use if you found helpful, otherwise, you can just ask them and annotate those issues (and this one) directly).
    • Gather Examples: Communication (style) Guide for Document Creation #27
    • Create a Guide/Template: Google Form design - Gather Hack for LA examples #58
  • Once done, remove the "TG: Gather Examples" label and add the "TG: Draft Template" label
• Create a draft template, either in markdown format in this issue or a google doc in the old product management google drive new product management google drive>Product Management Guides
  • Once done, remove the "TG: Draft Template" label and add the "TG: Create Guide" label
• Create a guide on how to use the template
  • Once done, remove the "TG: Create Guide" label and add the "TG: Review Guide" label
• Review the guide with product management communities of practice
  • Once done, remove the "TG: Review Guide" label and add the "TG: Leadership Review" label
• Present to Hack for LA leadership team for sign off
  • Once approved, remove the "TG: Leadership Review" label and add the "TG: Place Guide" label
• Possibly create an issue template on .github
  • Include link to template under resources if you add it as a template in .github

Resources

• Refer to Create a Guide/Template: How to Format A Guide #106 for how to write a guide and the guide template
• Update issue Tracker: Templates & Guides #104 with the name of item you are working

Projects to check

• 100 Automations
  • Issues
    • Communication (style) Guide for Document Creation 100Automations/Website#138
  • WIKI
    • Instructions for how to make a guide on their website: https://github.com/100Automations/Website/wiki/Guide-to-the-Guide-Template
    • template for making a guide on their website: https://github.com/100Automations/Website/wiki/guide_template.md
• 311 Data
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Access the Data
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• BallotNav
  • Issues BallotNav Communications Guide ballotnav#435
  • Communication Guide
• Civic Tech Index
  • Issues
    • CTI Communication (style) Guide for Document Creation template/examples civictechindex/CTI-website-frontend#711
• Civic Tech Jobs
  • Issues
    • Create a CTJ Communications guide CivicTechJobs#152
• Civic Tech Structure
  • Copy
• Data Science Projects
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Design Systems
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Engage
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Expunge Assist
  • Communication Guide
• Food Oasis
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• GreenEarthOS
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Guides
  • Issue Update One Sheet: Write for All product-management#60
  • Doc 1
  • Doc 2
• HomeUniteUs
  • Issues
    • Create Communication Style Guide. HomeUniteUs#315
• Internship
  • Communications Guide - WIP
• Lucky Parking
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Open Community Survey
  • Communication Guide - mostly done and a good example
• People Depot
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• TDM Calculator
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• VRMS
  • None as of 2022-04-07
  • I checked Issues, wiki and slack channels
• Hack for LA's Website
  • None as of 2021-09-1
• Youth Justice Nav
  • Issues
  • Update Communication guide YouthJusticeNav#63

External projects (with finished communication guides)

BOP Communications Guide for Document Creation
Copy of Get Your Refund Communications Guide for Document Creation

Communities of Practice

• UI/UX community of practice
  • None as of 2021-09-1

[aymarmsba]

Assignee, Labels, Project Board Placement, and Milestones for this issue in the Product Repo: