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

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 join this conversation on GitHub. Already have an account? Sign in to comment
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