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

Refactor README #9

Merged
merged 9 commits into from
Jun 14, 2024
Merged

Refactor README #9

merged 9 commits into from
Jun 14, 2024

Conversation

jgarber623
Copy link

This PR updates the README with an eye toward clarity, brevity, and consistency.

Notable changes include:

  • moving Acknowledgements into this file
  • aligning overall structure with our other open source projects like CargoSense/rubocop-cargosense
  • refactoring text for consistency, clarity, and correctness

Note that I didn't meaningfully changed the meaning or intent behind anything and certainly didn't change the examples.

- move Acknowledgements into this file
- align overall structure with our other open source projects like rubocop-cargosense
- refactor text for consistency, clarity, and correctness

Note that I don't think I meaningfully changed the meaning or intent behind anything and certainly didn't change the examples.
@jgarber623 jgarber623 self-assigned this Jun 14, 2024
@jgarber623 jgarber623 added the documentation-update Improvements or additions to documentation label Jun 14, 2024
Copy link
Member

@billylanchantin billylanchantin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you so much! This looks great :)

My comments are mostly nits because the refactor read quite solidly to me. There's one substantive piece of feedback about the placement of the "Usage" section which I feel somewhat strongly about (though not overly -- I could be convinced). Happy to discuss.

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
@jgarber623
Copy link
Author

@billylanchantin All feedback has been addressed and I requested a re-review at your convenience.

Copy link
Member

@billylanchantin billylanchantin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, found 2 more nits that I missed!

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
jgarber623-cargosense and others added 2 commits June 14, 2024 14:09
Co-authored-by: Billy Lanchantin <[email protected]>
Co-authored-by: Billy Lanchantin <[email protected]>
@jgarber623
Copy link
Author

Additional feedback implemented and review re-requested!

Copy link
Member

@billylanchantin billylanchantin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome work! 🚢 it!

@jgarber623 jgarber623 merged commit 3279c68 into main Jun 14, 2024
12 checks passed
@jgarber623 jgarber623 deleted the docs-cleanup branch June 14, 2024 18:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation-update Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants