Skip to content

Commit 3f3d2d7

Browse files
aduh95BethGriggs
authored andcommitted
doc: recommend test-doc instead of lint-md
The documentation style guide used to recommend checking changes in the docs by running `make lint-md`. This leaves out some important checks which are contained in the `test-doc` build target. This commit also replaces `lint` by `lint-md` in the list of `test-doc`'s prerequisites. PR-URL: #35708 Reviewed-By: Rich Trott <rtrott@gmail.com> Reviewed-By: Michael Dawson <midawson@redhat.com>
1 parent 67d3182 commit 3f3d2d7

File tree

2 files changed

+2
-2
lines changed

2 files changed

+2
-2
lines changed

Makefile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -596,7 +596,7 @@ test-hash-seed: all
596596
$(NODE) test/pummel/test-hash-seed.js
597597

598598
.PHONY: test-doc
599-
test-doc: doc-only lint ## Builds, lints, and verifies the docs.
599+
test-doc: doc-only lint-md ## Builds, lints, and verifies the docs.
600600
@if [ "$(shell $(node_use_openssl))" != "true" ]; then \
601601
echo "Skipping test-doc (no crypto)"; \
602602
else \

doc/guides/doc-style-guide.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ this guide.
1616
* Documents should be word-wrapped at 80 characters.
1717
* `.editorconfig` describes the preferred formatting.
1818
* A [plugin][] is available for some editors to apply these rules.
19-
* Check changes to documentation with `make lint-md`.
19+
* Check changes to documentation with `make test-doc -j` or `vcbuild test-doc`.
2020
* [Use US spelling][].
2121
* [Use serial commas][].
2222
* Avoid first-person pronouns (_I_, _we_).

0 commit comments

Comments
 (0)