CI: run doc8 on api-ref

Change-Id: I000ffe5915a1c74b0e4eeb93ceeb4aee429a1901
This commit is contained in:
Dmitry Tantsur 2020-07-28 12:45:09 +02:00
parent 9ecb6e33eb
commit a5e8cce1af
3 changed files with 19 additions and 18 deletions

View File

@ -14,11 +14,12 @@ Inspector API supports versioning. There are two kinds of versions:
- ``microversions``, which can be requested through the use of the
``X-OpenStack-Ironic-Inspector-API-Version`` header.
The Version APIs work differently from other APIs as they *do not* require authentication.
The Version APIs work differently from other APIs as they *do not* require
authentication.
All API requests support the ``X-OpenStack-Ironic-Inspector-API-Version`` header.
This header SHOULD be supplied with every request; in the absence of this header,
server will default to current supported version in all responses.
All API requests support the ``X-OpenStack-Ironic-Inspector-API-Version``
header. This header SHOULD be supplied with every request; in the absence of
this header, server will default to current supported version in all responses.
List API versions
=================
@ -44,8 +45,8 @@ Response Example
- links: links
- status: status
- x-openstack-ironic-api-min-version: x-openstack-ironic-inspector-api-minimum-version
- x-openstack-ironic-api-max-version: x-openstack-ironic-inspector-api-maximum-version
- x-openstack-ironic-inspector-api-min-version: api-minimum-version
- x-openstack-ironic-inspector-api-max-version: api-maximum-version
.. literalinclude:: samples/api-root-response.json
:language: javascript
@ -74,8 +75,8 @@ Response Example
- rel: rel
- name: name
- x-openstack-ironic-api-min-version: x-openstack-ironic-inspector-api-minimum-version
- x-openstack-ironic-api-max-version: x-openstack-ironic-inspector-api-maximum-version
- x-openstack-ironic-inspector-api-min-version: api-minimum-version
- x-openstack-ironic-inspector-api-max-version: api-maximum-version
.. literalinclude:: samples/api-v1-root-response.json
:language: javascript

View File

@ -1,23 +1,23 @@
# variables in header
x-auth-token:
description: |
The client token being passed into Ironic Inspector API to make
authentication.
in: header
required: true
type: string
x-openstack-ironic-inspector-api-maximum-version:
api-maximum-version:
description: |
Maximum API microversion supported by this endpoint, eg. "1.10"
in: header
required: true
type: string
x-openstack-ironic-inspector-api-minimum-version:
api-minimum-version:
description: |
Minimum API microversion supported by this endpoint, eg. "1.1"
in: header
required: true
type: string
x-auth-token:
description: |
The client token being passed into Ironic Inspector API to make
authentication.
in: header
required: true
type: string
x-openstack-ironic-inspector-api-version:
description: >
A request SHOULD include this header to indicate to the Ironic Inspector

View File

@ -44,7 +44,7 @@ commands =
[testenv:pep8]
commands =
flake8 ironic_inspector
doc8 README.rst CONTRIBUTING.rst doc/source
doc8 -e .rst -e .inc README.rst CONTRIBUTING.rst doc/source api-ref/source
[testenv:functional-py36]
commands =