Skip to content

Commit

Permalink
Add rstcheck support
Browse files Browse the repository at this point in the history
This tool checks reStructuredText syntax helping to detect non-trivial
documentation issues.

Signed-off-by: Victor Morales <v.morales@samsung.com>
  • Loading branch information
electrocucaracha committed Sep 7, 2022
1 parent e9571da commit 617a3db
Show file tree
Hide file tree
Showing 5 changed files with 9 additions and 1 deletion.
4 changes: 4 additions & 0 deletions .rstcheck.cfg
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
[rstcheck]
report_level=WARNING
ignore_directives=bibliography,
ignore_roles=cite:p,
3 changes: 2 additions & 1 deletion doc/gov/chapters/chapter09.rst
Original file line number Diff line number Diff line change
Expand Up @@ -154,7 +154,8 @@ Expectation #3: The Qualitative Survey

At the conclusion of the Test Case iterations, the participant will be asked to complete a qualitative survey of their experience. This survey will be used to measure the feasibility, utility, and effectiveness of the RI1 specifications, installation/configuration methods and RC-1 Test case efficacy. The survey will be in an Agile User Story format. The Table below provides an example of the survey questions:

![\ **Table 1:** Survey/Questionnaire example](../figures/Table 1-1.png)
.. image:: ../figures/Table_1-1.png
:alt: "Table 1: Survey/Questionnaire example"

**Table 1:** Survey/Questionnaire example

Expand Down
File renamed without changes
1 change: 1 addition & 0 deletions test-requirements.txt
Original file line number Diff line number Diff line change
Expand Up @@ -5,3 +5,4 @@ sphinx!=1.6.6,!=1.6.7,!=2.1.0,!=3.0.0,!=3.4.2 # BSD
doc8 # Apache-2.0
sphinx-material
pyspelling # MIT
rstcheck[sphinx] # MIT
2 changes: 2 additions & 0 deletions tox.ini
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ deps =
-chttps://opendev.org/openstack/requirements/raw/branch/stable/xena/upper-constraints.txt
-r{toxinidir}/test-requirements.txt
commands =
bash -c "find {toxinidir} -not -path {toxinidir}/.tox/\* \
-name \*.rst -type f -print0 | xargs -0 rstcheck"
sphinx-build --keep-going -W -T -b html -D language=en doc _build/html
sphinx-build --keep-going -W -b linkcheck doc _build/html
pyspelling -c .spellcheck.yml

0 comments on commit 617a3db

Please sign in to comment.