openstack/training-guides
Code Issues Proposed changes

Fix warnings of upstream training slides

Browse Source 
Most warnings can be addressed by using toctree directive
and there is no reason to use toctree directive.

In addition, sections in slide-index.rst has been reorganized
to match the sections in index.rst.
The sections in index.rst looks better.

Also specify -W option to sphinx-build so that the gate job
can detect warnings.

Change-Id: I70ca7c2b61cbbb48fd0ea5e6cc0d68aaa09b6d87
This commit is contained in:
Akihiro Motoki
2016-09-28 04:59:28 +09:00
parent 6dd5b12827
commit 9fab9582c2
2 changed files with 43 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
tox.ini
View File

@@ -28,7 +28,7 @@ commands =
doc8 doc/upstream-training
doc8 doc/training-guides
# Build upstream-training slides
sphinx-build -b slides -d doc/upstream-training/build/slides.doctrees doc/upstream-training/source/ doc/upstream-training/build/slides
sphinx-build -W -b slides -d doc/upstream-training/build/slides.doctrees doc/upstream-training/source/ doc/upstream-training/build/slides
# Build upstream landing page
sphinx-build -b html -d doc/upstream-training/build/slides.doctrees doc/upstream-training doc/upstream-training/build/slides
# Build training-guides slides