Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create a Guide/Template: Documentation Technologies #145

Open
7 tasks
Tracked by #55
CalvinTan607 opened this issue Jul 21, 2022 · 3 comments
Open
7 tasks
Tracked by #55

Create a Guide/Template: Documentation Technologies #145

CalvinTan607 opened this issue Jul 21, 2022 · 3 comments
Labels
Complexity: Missing CoP: Engineering feature : guide creation milestone: missing Phase: 1 - Gather Examples Solo size: missing status: 1.1 needs wiki examples Gathering examples by checking each team's wiki status: 1.2 needs issues examples Gathering examples by checking each team's issues status: 1.3 needs project board examples Gathering examples by checking each team's project board cards status: 1.4 needs slack examples Check each team's slack channel for examples

Comments

@CalvinTan607
Copy link

CalvinTan607 commented Jul 21, 2022

Overview

We need to create a guide to making a storage for your documentation, therefore we will write a guide discussing different documentation technologies that are available.

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

Projects to Check

Tasks

  • This is where you will copy instructions from the wiki page for the step you are currently on.
@CalvinTan607 CalvinTan607 self-assigned this Jul 21, 2022
@hkatzdev

This comment has been minimized.

@ExperimentsInHonesty ExperimentsInHonesty changed the title Create a Guide or Template: Documentation Technologies Create a Guide/Template: Documentation Technologies Oct 18, 2024
@JesseTheCleric
Copy link
Member

Prior version of issue

Overview

We need to create a guide to making a storage for your documentation, therefore we will write a guide discussing different documentation technologies that are available.

Action Items

  • Gather examples of how other projects have done it, adding each example as a link in the resources section
    • 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 Engineering google drive
    • 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

Update tracker issue (TBD) with the name of item you are working

@JesseTheCleric
Copy link
Member

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

Image

@JesseTheCleric JesseTheCleric transferred this issue from hackforla/engineering Feb 14, 2025
@JesseTheCleric JesseTheCleric added Phase: 1 - Gather Examples Solo status: 1.1 needs wiki examples Gathering examples by checking each team's wiki status: 1.3 needs project board examples Gathering examples by checking each team's project board cards status: 1.2 needs issues examples Gathering examples by checking each team's issues status: 1.4 needs slack examples Check each team's slack channel for examples size: missing milestone: missing Complexity: Missing feature : guide creation labels Feb 14, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Complexity: Missing CoP: Engineering feature : guide creation milestone: missing Phase: 1 - Gather Examples Solo size: missing status: 1.1 needs wiki examples Gathering examples by checking each team's wiki status: 1.2 needs issues examples Gathering examples by checking each team's issues status: 1.3 needs project board examples Gathering examples by checking each team's project board cards status: 1.4 needs slack examples Check each team's slack channel for examples
Projects
Status: Needs to be Triaged
Status: Needs to be Triaged
Development

No branches or pull requests

4 participants