Recently cliff introduced a sphinx extension directive named autoprogram-cliff
which genarates command-line help automatically. By using it, we no longer
need to write command-line help document separately.
Also fixes minor string substitution issue in a BGPVPN command.
Note that the new cliff release with the directive is not released yet,
but there are several number of OSC plugin commands proposed and
having a local copy would help such developers.
Change-Id: I6b1aee89f406ac449fbc43e210c4ca7ad901b19b
The new simple configuration way was introduced in
openstackdocstheme 1.11.0. This commit introduces the new way.
Also drops unnecessary sphinx configurations like latex,
texinfo and manpages.
Change-Id: I587eb8cbd3e64c65dfc7247a01eca90af6adad4e
In addition to the convention of releasenotes/source directory
which used in most OpenStack project, we have the release notes
in our developer documents.
Change-Id: Ied07af5ee5c8929e639e17a34b559cebfe419dc4
Remove intersphinx from the docs build as it triggers network calls that
occasionally fail, and we don't really use intersphinx (links other
sphinx documents out on the internet)
This also removes the requirement for internet access during docs build.
This can cause docs jobs to fail if the project errors out on
warnings.
Change-Id: I71e941e2a639641a662a163c682eb86d51de42fb
Related-Bug: #1368910
The current developer docs theme used is out of sync with the other
openstack projects. This patch will update the docs to provide a more
consistent look and feel when using developer docs
Change-Id: I03985039381c2ba4f81a2015258f7b49bba441d9
