Merge "Add doc8 linter to tox for spec validation"
This commit is contained in:
commit
e6a355ae61
@ -34,13 +34,13 @@ encouraged to use index entries for their documents to help with discovery.
|
|||||||
Naming
|
Naming
|
||||||
------
|
------
|
||||||
|
|
||||||
Document naming standards help readers find specs. For the StarlingX repository,
|
Document naming standards help readers find specs. For the StarlingX
|
||||||
the following document naming is recommended. The categories listed here are
|
repository, the following document naming is recommended. The categories listed
|
||||||
likely incomplete, and may need expansion to cover new cases. It is preferrable
|
here are likely incomplete, and may need expansion to cover new cases. It is
|
||||||
to deviate (and hopefully amend the list) than force document names into
|
preferrable to deviate (and hopefully amend the list) than force document names
|
||||||
nonsense categories. Prefer using categories that have previously been used or
|
into nonsense categories. Prefer using categories that have previously been
|
||||||
that are listed here over new categories, but don't force the category into
|
used or that are listed here over new categories, but don't force the category
|
||||||
something that doesn't make sense.
|
into something that doesn't make sense.
|
||||||
|
|
||||||
Document names should follow a pattern as follows::
|
Document names should follow a pattern as follows::
|
||||||
|
|
||||||
|
@ -1,2 +1,3 @@
|
|||||||
PyYAML>=3.1.0
|
PyYAML>=3.1.0
|
||||||
yamllint>=0.5.2
|
yamllint>=0.5.2
|
||||||
|
doc8
|
||||||
|
Loading…
Reference in New Issue
Block a user