00a3832886
Implements blueprint horizon-dev-setup-doc-update. Change-Id: I0d16a5db7b8b7b670e76a99792f744e6ff0e00a2
75 lines
2.3 KiB
Plaintext
75 lines
2.3 KiB
Plaintext
OpenStack Dashboard (Horizon)
|
|
-----------------------------
|
|
|
|
The OpenStack Dashboard is a Django based reference implementation of a web
|
|
based management interface for OpenStack.
|
|
|
|
It is based on the ``horizon`` module, which is designed to be a generic Django
|
|
app that can be re-used in other projects.
|
|
|
|
For more information about how to get started with the OpenStack Dashboard,
|
|
view the README file in the openstack-dashboard folder.
|
|
|
|
For more information about working directly with ``horizon``, see the
|
|
README file in the ``horizon`` folder.
|
|
|
|
For release management:
|
|
|
|
* https://launchpad.net/horizon
|
|
|
|
For blueprints and feature specifications:
|
|
|
|
* https://blueprints.launchpad.net/horizon
|
|
|
|
For issue tracking:
|
|
|
|
* https://bugs.launchpad.net/horizon
|
|
|
|
Project Structure and Testing:
|
|
------------------------------
|
|
|
|
This project is a bit different from other OpenStack projects in that it has
|
|
two very distinct components underneath it: ``horizon``, and
|
|
``openstack-dashboard``.
|
|
|
|
The ``horizon`` directory holds the generic libraries and components that can
|
|
be used in any Django project. In testing, this component is set up with
|
|
buildout (see ``run_tests.sh``), and any dependencies that get added need to
|
|
be added to the ``horizon/buildout.cfg`` file.
|
|
|
|
The ``openstack-dashboard`` directory contains a reference Django project that
|
|
uses ``horizon`` and is built with a virtualenv and tested through that
|
|
environment. If dependencies are added that ``openstack-dashboard`` requires
|
|
they should be added to ``openstack-dashboard/tools/pip-requires``.
|
|
|
|
The ``run_tests.sh`` script invokes tests and analyses on both of these
|
|
components in its process, and is what Jenkins uses to verify the
|
|
stability of the project.
|
|
|
|
To run the tests::
|
|
|
|
$ ./run_tests.sh
|
|
|
|
Building Contributor Documentation
|
|
----------------------------------
|
|
|
|
This documentation is written by contributors, for contributors.
|
|
|
|
The source is maintained in the ``docs/source`` folder using
|
|
`reStructuredText`_ and built by `Sphinx`_
|
|
|
|
.. _reStructuredText: http://docutils.sourceforge.net/rst.html
|
|
.. _Sphinx: http://sphinx.pocoo.org/
|
|
|
|
* Building Automatically::
|
|
|
|
$ ./run_tests.sh --docs
|
|
|
|
* Building Manually::
|
|
|
|
$ export DJANGO_SETTINGS_MODULE=local.local_settings
|
|
$ python doc/generate_autodoc_index.py
|
|
$ sphinx-build -b html doc/source build/sphinx/html
|
|
|
|
Results are in the `build/sphinx/html` directory
|