Create a Guide/Template: Site Architecture Documentation

[ExperimentsInHonesty]

Overview

We need to create a guide to making Site Architecture Documentation (wiki) so that New developers understand how the site is organized and so that complex integrations have complete documentation to aid in changes down the road.

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 Hack for LA website Architecture document

[Wny-Duong]

Projects to check

Documentation Found

• 100 Automations

• 311 Data

• Civic Tech Index

• Civic Tech Jobs

• Hack for LA's Website

• VRMS*

Documentation Not Found

• Access the Data
• BallotNav***
• Brigade Organizer's Playbook**
• Civic Tech Structure
• Data Science Projects
• Design Systems
• Engage**
• Expunge-Assist (formerly known as Record Clearance)**
• Food Oasis***
• Guides**
• GreenEarthOS***
• HomeUniteUs***
• Internship project**
• Lucky Parking
• Open Community Survey
• People Depot
• Tables team
• TDM Calculator
• Youth Justice Nav**

*Only architecture for UI documented/diagrammed. **Uses wiki draft template indicating awareness of the need for site architecture documentation ***May have information within Google Drive.

[ExperimentsInHonesty]

@Wny-Duong Please provide update

1. Progress: "What is the current status of your project? What have you completed and what is left to do?"
2. Blockers: "Difficulties or errors encountered."
3. Availability: "How much time will you have this week to work on this issue?"
4. ETA: "When do you expect this issue to be completed?"
5. Pictures or links* (if necessary): "Add any pictures or links that will help illustrate what you are working on."

• remember to add links to the top of the issue if they are going to be needed again.