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

MB-15466-Update readme instructions #333

Merged
merged 8 commits into from
Apr 25, 2023
Merged

Conversation

NamibiaTorres
Copy link
Contributor

The purpose of this PR is to add sections to the README about testing and updating the documentation so that it informs engineers who may need to make changes to the docs.

Copy link
Contributor

@ronaktruss ronaktruss left a comment

Choose a reason for hiding this comment

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

Thanks for adding this! This has been information that has been passed along the grapevine for a while so it's nice to finally codify it.

Preface: For nits feel free to address the ones that you actually agree with. If you're on the fence you don't need to make the changes.

General nit: I think all of the headers should have an empty line after and code-block should have an empty line before and after. These seem to be fairly common suggestions across different markdown style guides. (If we really want to enforce these we should leverage automation and include it as part of the build process. Fwiw, your editor might have a pluggin that enables quick fixes for this. There are also cli tools for this. Eg. https://github.com/markdownlint/markdownlint and https://github.com/DavidAnson/markdownlint.)

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
Copy link
Contributor

@kctruss kctruss left a comment

Choose a reason for hiding this comment

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

💖 This additional information is really useful, thank you for adding it!

@NamibiaTorres NamibiaTorres merged commit f5a3695 into main Apr 25, 2023
3 checks passed
@NamibiaTorres NamibiaTorres deleted the update-readme-instructions branch April 25, 2023 17:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants