diff options
| author |   thmsdt <thomas.kulik@telekom.de> | 2021-10-19 12:05:48 +0200 |
|---|---|---|
| committer | thmsdt <thomas.kulik@telekom.de> | 2021-11-17 10:33:17 +0100 |
| commit | d6b7f66b0d3cbc4e7c92a85837a8e74906c08434 (patch) | |
| tree | af702ffc4e707f71c72f0368e2abc40fe97ab6cf /examples/sphinx/README.md | |
| parent | eb3b0515916012651dc8f4fb8c432da13759ec56 (diff) | |
Add sphinx example configuration files
Issue-ID: DOC-772
Signed-off-by: thmsdt <thomas.kulik@telekom.de>
Change-Id: I2cb913388cb1db28400de12d31fc74776627e9e8
Diffstat (limited to 'examples/sphinx/README.md')
| -rw-r--r-- | examples/sphinx/README.md | 66 |
1 files changed, 66 insertions, 0 deletions
diff --git a/examples/sphinx/README.md b/examples/sphinx/README.md new file mode 100644 index 000000000..e8decf9a4 --- /dev/null +++ b/examples/sphinx/README.md @@ -0,0 +1,66 @@ +# Examples files + +Examples files for a working (basic) configuration of sphinx. +To be used by all ONAP projects (except 'doc' project). +Extend them to reflect the needs in your project. +Please note the different pathes, the files are located in! + +## FILE: tox.ini_MASTER + +##### USE: +in MASTER branch of your repository +##### PATH: +{project}/docs +##### TODO: +remove _MASTER from filename + +## FILE: tox.ini_NEWBRANCH + +##### USE: +in 'NEWBRANCH' of your repository +##### PATH: +{project}/docs +##### TODO: +remove _NEWBRANCH from filename + +update release name in the following lines: +``` +-chttps://git.onap.org/doc/plain/etc/upper-constraints.os.txt?h=istanbul +-chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=istanbul +``` + +## FILE: conf.py_MASTER + +##### USE: +in MASTER branch of your repository +##### PATH: +{project}/docs +##### TODO: +remove _MASTER from filename + +## FILE: conf.py_NEWBRANCH + +##### USE: +in 'NEWBRANCH' of your repository +##### PATH: +{project}/docs +##### TODO: +remove _NEWBRANCH from filename + +## FILE: requirements-docs.txt + +##### USE: +in both, MASTER branch and 'NEWBRANCH' of your repository +##### PATH: +{project}/docs +##### TODO: +– + +## FILE: .readthedocs.yaml + +##### USE: +in both, MASTER branch and 'NEWBRANCH' of your repository +##### PATH: +{project} +##### TODO: +– |