skyline/doc
yangshaoxue c069ce5aaf docs: add development guide
add development guide

Change-Id: Id8fcac77eb5691e297f99cfe845c1b53bf1709bf
2022-09-08 18:12:42 +08:00
..
source docs: add development guide 2022-09-08 18:12:42 +08: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