diff mbox series

[v2,1/2] README: add instruction to run Vale on a subset

Message ID 20241104-add-bblock-documentation-v2-1-74a8a2cff0f8@baylibre.com
State New
Headers show
Series Add bblock documentation | expand

Commit Message

Julien Stephan Nov. 4, 2024, 3:59 p.m. UTC
make stylecheck runs Vale on the whole documentation which can be long
and reports a lot of errors/warnings. We can run Vale on a subset using
the VALEDOCS variable, so update documentation to highlight it.

Signed-off-by: Julien Stephan <jstephan@baylibre.com>
---
 documentation/README | 8 ++++++++
 1 file changed, 8 insertions(+)
diff mbox series

Patch

diff --git a/documentation/README b/documentation/README
index c888b666a8632a1d6f576c68e4f9ca966d79f134..8ac8d5236793774586abddfd89cf1b3daa680edc 100644
--- a/documentation/README
+++ b/documentation/README
@@ -142,6 +142,14 @@  To run Vale:
 
  $ make stylecheck
 
+Style checking the whole documentation might take some time and generate a
+lot of warnings/errors, thus one can run Vale on a subset of files or
+directories:
+
+  $ make stylecheck VALEDOCS=<file>
+  $ make stylecheck VALEDOCS="<file1> <file2>"
+  $ make stylecheck VALEDOCS=<dir>
+
 Link checking the Yocto Project documentation
 =============================================