diskimage-builder/doc/source/index.rst
Ian Wienand 78c0766bec Produce API documentation
There's an increasing amount of pydoc based documentation.  Output the
module reference and link it into the developers main page.

One fixup to the rst needed

Change-Id: I1d43a1fe1c735eb4559e3d2b40834d1c8115c586
2017-05-25 14:26:31 +10:00

64 lines
1.7 KiB
ReStructuredText

Diskimage-builder Documentation
===============================
``diskimage-builder`` is a tool for automatically building customized
operating-system images for use in clouds and other environments.
It includes support for building images based on many major
distributions and can produce cloud-images in all common formats
(``qcow2``, ``vhd``, ``raw``, etc), bare metal file-system images and
ram-disk images. These images are composed from the many included
``elements``; ``diskimage-builder`` acts as a framework to easily add
your own elements for even further customization.
``diskimage-builder`` is used extensively by the `TripleO project
<https://wiki.openstack.org/wiki/TripleO>`__ and within `OpenStack
Infrastructure <http://docs.openstack.org/infra/system-config/>`__.
Code
----
Release notes for the latest and previous versions are available at:
* `http://docs.openstack.org/releasenotes/diskimage-builder/
<http://docs.openstack.org/releasenotes/diskimage-builder/>`__
The code is available at:
* `https://git.openstack.org/cgit/openstack/diskimage-builder/
<https://git.openstack.org/cgit/openstack/diskimage-builder/>`__
Issues
------
Issues are tracked on launchpad at:
* `<https://bugs.launchpad.net/diskimage-builder/+bugs>`__
Communication
-------------
Communication among the diskimage-builder developers happens on IRC in
``#openstack-dib`` on freenode and on the ``openstack-dev`` mailing list
(``openstack-dev@lists.openstack.org``).
Table of Contents
-----------------
.. toctree::
:maxdepth: 2
user_guide/index
developer/index
elements
specs/README
.. # just link this on the dev page
.. toctree::
:hidden:
api/autoindex