skyline/doc
2022-09-13 10:09:40 +00:00
..
source Merge "docs: remove skyline settings file" 2022-09-13 10:09:40 +00:00
README.rst feat: Add doc base frame 2022-08-01 14:28:07 +08:00
requirements.txt feat: Add doc base frame 2022-08-01 14:28:07 +08:00

================================
Skyline Console Development Docs
================================

Files under this directory tree are used for generating the documentation
for the skyline-console source code.

Developer documentation is built to:
https://docs.openstack.org/skyline-console/latest/

Tools
=====

Sphinx
  The Python Sphinx package is used to generate the documentation output.
  Information on Sphinx, including formatting information for RST source
  files, can be found in the `Sphinx online documentation
  <http://www.sphinx-doc.org/en/stable/>`_.

Graphviz
  Some of the diagrams are generated using the ``dot`` language
  from Graphviz. See the `Graphviz documentation <http://www.graphviz.org/>`_
  for Graphviz and dot language usage information.


Building Documentation
======================

Doc builds are performed using tox with the ``docs`` target::

 % cd ..
 % tox -e docs