1
0
mirror of https://git.yoctoproject.org/poky synced 2026-05-30 00:20:08 +00:00

manuals: add initial stylechecks with Vale

Use the "Vale" (https://vale.sh) tool to perform text style checks
Run "make stylecheck" to run the checks.

This just checks the text, not the Sphinx syntax style choices.

(From yocto-docs rev: e3e4ba2aa963d4d178c4e9e842e66f4ee4bd3736)

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Suggested-by: Thomas Petazzoni <thomas.petazzoni@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
This commit is contained in:
Michael Opdenacker
2024-03-12 21:58:39 +01:00
committed by Steve Sakoman
parent 85da954465
commit 15034b32a5
7 changed files with 58 additions and 1 deletions
+15
View File
@@ -5,6 +5,21 @@ documentation is created.
It is currently a work in progress.
## Automatic style validation
There is an ongoing effort to automate style validation
through the [Vale](https://vale.sh/). To try it, run:
$ make stylecheck
Note that this just applies to text. Therefore, the syntax
conventions described below still apply.
If you wish to add a new word to an "accept.txt" file
(./styles/config/vocabularies/<Vocab>/accept.txt),
make sure the spelling and capitalization matches
what Wikipedia or the project defining this word uses.
## Text standards
This section has not been filled yet