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

doc: mention markdown linting in BUILDING.md #28578

Closed
wants to merge 1 commit into from

Conversation

srcmake
Copy link
Contributor

@srcmake srcmake commented Jul 6, 2019

In the Running Tests section of BUILDING.md, there's a sentence that says make lint runs JavaScript and C++ linting. However, make lint also runs a Markdown linter. This PR updates that sentence in the documentation to mention that Markdown linting is run.

Which is super useful to know since small documentation change PRs don't need the full test suite run, and make lint is good enough for testing. (I think.)

Checklist

@nodejs-github-bot nodejs-github-bot added build Issues and PRs related to build files or the CI. doc Issues and PRs related to the documentations. labels Jul 6, 2019
BUILDING.md Outdated
@@ -322,8 +322,7 @@ Make sure the linter does not report any issues and that all tests pass. Please
do not submit patches that fail either check.

If you want to run the linter without running tests, use
`make lint`/`vcbuild lint`. It will run both JavaScript linting and
C++ linting.
`make lint`/`vcbuild lint`. It will run JavaScript, C++, and Markdown linting.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
`make lint`/`vcbuild lint`. It will run JavaScript, C++, and Markdown linting.
`make lint`/`vcbuild lint`. It will lint JavaScript, C++, and Markdown files.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done.

BUILDING.md mentioned JS and C++ linting were performed
in the 'make lint' command, but 'make lint' also
performs markdown linting. This commit updates the docs
to include markdown as one of the things being linted.
@srcmake
Copy link
Contributor Author

srcmake commented Jul 6, 2019

Updated with Trott's suggestion. The wording is much nicer now.

@Trott
Copy link
Member

Trott commented Jul 8, 2019

@Trott Trott added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Jul 8, 2019
@Trott
Copy link
Member

Trott commented Jul 8, 2019

Landed in 7e50bb3

@Trott Trott closed this Jul 8, 2019
Trott pushed a commit to Trott/io.js that referenced this pull request Jul 8, 2019
BUILDING.md mentioned JS and C++ linting were performed
in the 'make lint' command, but 'make lint' also
performs markdown linting. This commit updates the docs
to include markdown as one of the things being linted.

PR-URL: nodejs#28578
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
targos pushed a commit that referenced this pull request Jul 20, 2019
BUILDING.md mentioned JS and C++ linting were performed
in the 'make lint' command, but 'make lint' also
performs markdown linting. This commit updates the docs
to include markdown as one of the things being linted.

PR-URL: #28578
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
This was referenced Jul 23, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
author ready PRs that have at least one approval, no pending requests for changes, and a CI started. build Issues and PRs related to build files or the CI. doc Issues and PRs related to the documentations.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants