Home
The Hack for LA Guides project is creating guides and templates from the effective practices that HfLA has developed and iterated from our projects. HfLA Guides aim to share replicable processes and practices from Engineering, UI/UX, Product Management, Data Science, Marketing Fundraising, DevOps, Admin, and Professional Development. The project seeks to further grow HfLA’s peer learning and iterative culture, and ultimately improve outcomes for the entire civic tech ecosystem.
The Guides Team is a group of people dedicated to managing the guides that were created by members of the Communities of Practice in Hack For LA
The Guides Team manage guides in order to help both Hack For LA volunteers and anyone on the internet find the necessary resources they need to do a practice
We have surveyed many Civic Tech organizations, from 18F to Code for America. They all have some guides, but none have a comprehensive set.
We aim to create a set of guides with practical examples from real projects. Ideally, you would take guidance, from working projects. Meaning, guidance without proof that it's coming from a successful example is less valuable than one that you can see working. For instance, people often reference practices at companies like eBay, Amazon, Google, etc. As evidence for the quality of the practice.
Make guidance so simple to follow that even a total novice can do the process or practice effectively. Work with people who are doing the practice to understand what works and what does not.
You can access our project one sheet here.
- A document with step-by-step instructions and examples of how to do a process or practice
- Overview
- Volunteers and organization leads identify questions people have about how to do things on Hack for LA projects
- Issues are Made to create a Guide and sometimes a template to go with that guide
- People self assign a guide and connect with other teams to find out if they have experience/examples of doing the process or practice on their team
- After gathering the examples, the assignee writes up a guide, using the guides templates, on how to do it, and then tests that guide with other teams, that were identified during the gathering examples stage.
- The guide gets a leadership review
- The is published on our website
- You can look at our comprehensive set of slide presentations on how to start working on a guide:
- Part 1: What is a Guide & Picking Your First Guide
- Part 2: Gathering Examples With Github: Wiki, Issues, Project Board, Resources Provided
- Part 3: Gathering Examples With Slack
- Part 4: Connecting with Other Teams & Moving the Conversation Forward
- Part 5: Making a Special Issue + Last Check w/ Org Rep
- A Process has a defined set of instructions for how to execute something from beginning to end.
- A Practice is a set of guidance and examples for how to organize something. Each team who uses the practice will execute it differently from the others that come before, as the needs of their project dictate.
- Example: How to Write a Research Plan
- On our Guide Resources page
- Work in progress issues for guides can be found on the Guides Tracker
- Guides Tracker column for Guides that are almost done
We are working on a knowledge base for Hack for LA (not just guides). Get a preview of how it will look here in our Figma mockup of the Toolkit page on hackforla.org website
- Authors add their names to the Guide document
- They also include their social media addresses such as LinkedIn, GitHub, and Email
- Future feature: we plan to have a drop-down search to see all guides contributed to by a specific author. Authors will be able to link to all the guides they worked on (can add a link to their portfolio).