8afdedab30
This PS adds tooling and automation to automatically generate
Drydock's documentation into feature-rich HTML pages that can
be hosted.
To run the documentation job, simply execute:
tox -e docs
A future PS should add warning_is_error to 'build_sphinx' in
setup.py once the import warnings are addressed.
Change-Id: I91a3c585b2c27096e7fde12d180638d1ae4bdb81
27 lines
1.1 KiB
ReStructuredText
27 lines
1.1 KiB
ReStructuredText
..
|
|
Copyright 2017 AT&T Intellectual Property. All other rights reserved.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
|
|
Sample Configuration File
|
|
==========================
|
|
|
|
The following is a sample Drydock configuration for adaptation and use. It is
|
|
auto-generated from Drydock when this documentation is built, so
|
|
if you are having issues with an option, please compare your version of
|
|
Patrole with the version of this documentation.
|
|
|
|
The sample configuration can also be viewed in `file form <_static/drydock.conf.sample>`_.
|
|
|
|
.. literalinclude:: _static/drydock.conf.sample
|