search

hackforla / knowledgebase-content

GNU General Public License v2.0
1 stars 0 forks source link

Create a Guide/Template: Readme for your project #76

Open erigilg opened 3 years ago

erigilg commented 3 years ago

Overview

We need to create a guide to making the Readme file of every project. This file should have the information people may need before they start contributing to the project. Typically for a software project that would be an overview, goals, development process, technology, etc.

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.

Projects that have been checked

Projects that have not been checked

Inactive or completed projects (do not use for examples)

Readme for Civic Opportunity Project Readme for Railstats LA

Tasks

Olivia-Chiong commented 3 years ago

hi @Rabia2219 Please update the following

Rabia2219 commented 3 years ago

Hi @Olivia-Chiong Do we have something like this for Readmes? (https://github.com/hackforla/product-management/issues/3) (https://docs.google.com/spreadsheets/d/1OJOKJDhUzzMzaFwmbGoOdh5Ohh53LCwS4u7LulVvBsQ/edit#gid=0) I did try searching in Issues but was unable to find anything. Thank you.

Rabia2219 commented 3 years ago

@Olivia-Chiong Hi Olivia, Sorry I'm not able to make the meeting today. I've updated the Readme Guide as per our discussion. It is ready for another review. As per our discussion:

ExperimentsInHonesty commented 2 years ago

@Rabia2219 It looks like this issue is not yet complete. Here are my suggestions for improvement

  1. finish finding all the README.md's for the projects
  2. identify types of information contained and provide examples
  3. meet with the project teams to find out what they think the purpose of the README on their repo is.
fchan218 commented 1 month ago
Prior version of issue

### Overview We need to create a guide to making the Readme file of every project. This file should have the information people may need before they start contributing to the project. Typically for a software project that would be an overview, goals, development process, technology, etc. ### Action Items - [x] Gather examples of how other projects have done, adding each example as a link in the resources section - [x] Once done, remove the "TG: Gather Examples" label and add the "TG: Draft Template" label - [x] Create a draft template, either in markdown format in this issue or a google doc in the ~[old product management google drive](https://drive.google.com/drive/folders/1lO8k_0Z1UejkuRlNMYlUl2xlqgyBmvrF?usp=sharing)~ [new product management google drive>Product Management Guides](https://drive.google.com/drive/folders/1u9YOTWevHwEiHP8-r8d00rlqOn6q8e-5?usp=sharing) - [x] Once done, remove the "TG: Draft Template" label and add the "TG: Create Guide" label - [x] Create a guide on how to use the template - [x] Once done, remove the "TG: Create Guide" label and add the "TG: Review Guide" label - [x] 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 issue hackforla/knowledgebase-content#104 with the name of item you are working Guide [README draft](https://docs.google.com/document/d/1fXGwBUv8qKL1HcnoYkVwx0aWwYyuwbIATKYbT8nRSbI/edit) Template (https://github.com/hackforla/.github/blob/f8f282d8ba0a658abf85b46ef1e31ad1aa26c871/README.md) [A curated list of awesome READMEs from non HfLA repos](https://github.com/matiassingers/awesome-readme) ### Projects that have been checked - [100 Automations](https://github.com/100automations/website) - [readme](https://github.com/100Automations/Website/blob/gh-pages/README.md) - [BallotNav](https://github.com/hackforla/ballotnav) - [Readme for BallotNav](https://github.com/hackforla/ballotnav#readme) - [Expunge-Assist (formerly known as Record Clearance)](https://github.com/hackforla/expunge-assist) - [Readme for Expunge Assist](https://github.com/hackforla/expunge-assist/blob/master/README.md) - [Food Oasis](https://github.com/hackforla/food-oasis) - [Readme for Food Oasis](https://github.com/hackforla/food-oasis/blob/develop/README.md) - [Lucky Parking](https://github.com/hackforla/lucky-parking) - [Readme for Lucky Parking](https://github.com/hackforla/lucky-parking/blob/master/README.md) ### Projects that have not been checked - [311 Data](https://github.com/hackforla/311-data) - [Access the Data](https://github.com/hackforla/access-the-data) - [Brigade Organizer's Playbook](https://github.com/codeforamerica/brigade-playbook) - [Civic Tech Index](https://github.com/civictechindex/CTI-website-frontend) - [Civic Tech Jobs](https://github.com/hackforla/CivicTechJobs) - [Civic Tech Structure](https://github.com/hackforla/civic-tech-structure) - [Data Science Projects](https://github.com/hackforla/data-science) - [Design Systems](https://github.com/hackforla/design-systems) - [Engage](https://github.com/hackla-engage) - [GreenEarthOS](https://github.com/hackforla/climate-project) - [Guides](https://github.com/hackforla/guides) - [HomeUniteUs](https://github.com/hackforla/homeuniteus) - [Internship project](https://github.com/hackforla/intership) - [Open Community Survey](https://github.com/hackforla/open-community-survey) - [TDM Calculator](https://github.com/hackforla/tdm-calculator) - [VRMS](https://github.com/hackforla/vrms) - [Hack for LA's Website](https://github.com/hackforla/website) - [Youth Justice Nav](https://github.com/hackforla/YouthJusticeNav/) ### Inactive or completed projects (do not use for examples) [Readme for Civic Opportunity Project ](https://github.com/hackforla/civic-opportunity/blob/master/README.md) [Readme for Railstats LA](https://github.com/metro-ontime/performance_tracker/blob/master/README.md)

fchan218 commented 1 month ago
Assignee, Labels, Project Board Placement, and Milestones for this issue in the Product Repo:

Screenshot 2024-10-16 at 5 33 03 PM

fchan218 commented 1 month ago

Files in this issue:

fchan218 commented 1 month ago

@Rabia2219 This guide issue is moving to the knowledgebase-content repo. If you would like to maintain edit access to the issue and its associated files, please fill out the Google Drive Access Form.