Luigi Toscano eb79f2b7ed Fix and improve the HTML build, add the PDF build

- make it compatible with latest sphinx:
  * update the requirements (sphinx,
    openstackdocstheme as suggested its maintainers, yasfb)
  * update redirect.py by replacing the API which are not available anymore
    (thanks to nova-specs's https://review.opendev.org/648670)
  * following that review, clean and update conf.py;
- improve the structure of the document. Group by top-level sections
  whenever it makes sense (one for each release of Sahara, and one
  for each additional component). This reduces the number of chapter
  and it makes the document more readable;
- add the required pdf-docs tox environment;
- make sure that the docs tox environment only removes the html builds;
- only show the search section when the HTML generator is used (and fix
  its header when it is shown);
- disable the too smart smartquotes option for the latex builder;
- replace the py27 job with a py36 one to run the (few) internal tests.

Story: 2006117
Task: 35496
Change-Id: I9ac4fa81a80ee36af9e5278fc4a0792689c5a10a

2019-09-20 17:04:48 +02:00

556 B

Raw Blame History

Backlog

This directory is for specifications that have been approved but not yet implemented. If you are interested in implementing one of these specifications submit a review request moving it to the appropriate release.

The updated review should reflect the new primary assignee. Please maintain all previous assignees in the list of Other Contributors.

If a specification has been partially implemented, the document in the backlog will contain information of what has been completed.

backlog/*

556 B Raw Blame History

Backlog

556 B

Raw Blame History