d12927a156
Readthedocs failed to render Promenade exceptions with error: > WARNING: autodoc: failed to import exception 'xxx' from module > 'promenade'; the following exception was raised: No module > named 'falcon' Trying to add Promenade requirements to the installed requirements list, so that Readthedocs has all modules, including those needed for the Promenade itself. Unify docs building by utilizing Zuul docs-on-readthedocs template job. Cosmetic readability changes: 1. combined all Makefile .PHONY targets into one 2. merged multiple LABEL instructions in Dockerfile into one Change-Id: I731ee3426a631fa765f13ba7091dcb4b9ebd0353
28 lines
702 B
YAML
28 lines
702 B
YAML
# .readthedocs.yml
|
|
# Read the Docs configuration file
|
|
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
|
|
|
|
# Required
|
|
version: 2
|
|
|
|
# Build documentation in the doc/ directory with Sphinx
|
|
sphinx:
|
|
configuration: doc/source/conf.py
|
|
|
|
# Build documentation with MkDocs
|
|
#mkdocs:
|
|
# configuration: mkdocs.yml
|
|
|
|
# Optionally build your docs in additional formats such as PDF and ePub
|
|
formats:
|
|
- pdf
|
|
|
|
# Optionally set the version of Python and requirements required to build your docs
|
|
python:
|
|
version: 3.7
|
|
install:
|
|
- requirements: doc/requirements.txt
|
|
- requirements: requirements.txt
|
|
- requirements: requirements-direct.txt
|
|
- requirements: requirements-frozen.txt
|