summaryrefslogtreecommitdiffstats
path: root/tox.ini
AgeCommit message (Collapse)AuthorFilesLines
2021-02-10[COMMON] Update words whitelist URLGuillaume Lambert1-1/+1
cf https://gerrit.onap.org/r/c/doc/+/117667 https://gerrit.onap.org/r/c/doc/+/117668 Issue-ID: OOM-2648 Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com> Change-Id: Iea01dd783ba2467bee5aee5f2ac9db1cee6f99d7
2021-02-10[COMMON] Add a spellchecker tox profileGuillaume Lambert1-0/+12
inspired from openStack https://github.com/openstack/qa-specs/blob/master/tox.ini https://doughellmann.com/blog/tag/sphinxcontrib-spelling/ https://pypi.org/project/sphinxcontrib-spelling/ Issue-ID: OOM-2648 Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com> Change-Id: Ia341f96a906c82f88257a885fd66005450a15d16
2021-02-02[COMMON] Fix tox docs profiles configurationGuillaume Lambert1-1/+1
- sphinx-build '-W' option needed only once - remove docs/tox.ini since * same profiles are declared in tox.ini * once run from the docs folder, this generates invalid files in doc/.tox for linters setup (e.g. docs/.tox/[..]/invalid.rst). They can cause warnings treated as errors by root tox profiles. - modify requirements.txt to force a sphinxcontrib-needs version prior to 0.6.0 . This latest version introduces a new services support functionality that cannot be easily disabled here and that requires additional configuration parameters to link GitHub issues. We cannot provide these parameters since this project uses JIRA. As a result, sphinx generates a warning treated as an error that makes the gate fail. https://sphinxcontrib-needs.readthedocs.io/en/service/services/index.html Issue-ID: OOM-2648 Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com> Change-Id: I14e9045482750f15a3e5e98af47197e2c9f60f60
2020-12-11[COMMON] Remove parallelism in doc lintingSylvain Desbureaux1-2/+2
`sphinxcontrib.needs` is not safe for parallel work and thus a warning is set during linting which makes it fail. We then remove the parallelism for sphinx here. Issue-ID: OOM-2648 Signed-off-by: Sylvain Desbureaux <sylvain.desbureaux@orange.com> Change-Id: I820e63fee78578794c96c3ff9867c4ecc56ba50e
2020-12-09[COMMON] Add doc lintingSylvain Desbureaux1-0/+19
Add 3 automated doc linting (sphinx building, linkchecking and doc8) in order to have an error free documentations Fix also issues found by these linters in order to start without errors. Issue-ID: OOM-2648 Signed-off-by: Sylvain Desbureaux <sylvain.desbureaux@orange.com> Change-Id: I318718c956020412a120ba3caeb9e21d35a99833
2020-12-08[COMMON] Add git commit lintingSylvain Desbureaux1-0/+14
Add an automated git commit linting in order to be sure commit messages are set the way we want. Issue-ID: OOM-2644 Signed-off-by: Sylvain Desbureaux <sylvain.desbureaux@orange.com> Change-Id: I36a397c318886f2ac05a8971147272669c7a4cd9