Skip to content
This repository has been archived by the owner on Feb 19, 2025. It is now read-only.

chore(docs): Update README #505

Open
EandrewJones opened this issue Oct 9, 2024 · 2 comments
Open

chore(docs): Update README #505

EandrewJones opened this issue Oct 9, 2024 · 2 comments
Labels
Documentation Instructional Material and Reference Good First Issue Stuff for folks new to project help wanted

Comments

@EandrewJones
Copy link
Contributor

Problem

Our README is stale, has broken links (ex: "What's New" in the TOC), and is not sufficient for newcomers to immediately get off the ground without running into issues.

Solution

  • Remove stale parts
  • Update links
  • Make link to CONTRIBUTING.md and who should go there obvious
@EandrewJones EandrewJones added help wanted Documentation Instructional Material and Reference Good First Issue Stuff for folks new to project labels Oct 9, 2024
@krishna-dave206
Copy link

@EandrewJones I would like to work on this issue. It'd be great if you can brief a bit more and assign this issue to me

@EandrewJones
Copy link
Contributor Author

@krishna-dave206 You can absolutely pick this up.

The first step is to attempt to follow the steps for setting up and using the project based on the README as is. Anywhere the directions are unclear or things do not work as written, we know that's a place we need to improve the documentation. Flag these and share here, so we can iterate with you to improve the docs.

A secondary step, after we iterate through the above improvements, is to go through the existing README and test to see which links are broken (i.e. point to non-existent external websites or other sections of the README). Remove these or flag them and we can tell you whether there's a new, correct resource to point to. I'll try to find some time to make a pass and identify specific things I know are broken.

Finally, we have a new CONTRIBUTING.md with much better guidelines about how to contribute to the project, but that's not well-reflected in the README. We should update the existing contributing section to point directly to our CONTRIBUTING.md.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Documentation Instructional Material and Reference Good First Issue Stuff for folks new to project help wanted
Projects
None yet
Development

No branches or pull requests

2 participants