summaryrefslogtreecommitdiffstats
path: root/examples/sphinx/README.md
blob: e8decf9a4d4eb861017de2eb473c7e14a83d054b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
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:
–