Merge "[Docs] Restructuring"

This commit is contained in:
Jenkins 2016-11-15 21:20:50 +00:00 committed by Gerrit Code Review
commit c47623f8bb
50 changed files with 70 additions and 68 deletions

View File

@ -1,11 +1,12 @@
.. _developer-guide:
Developer guide
~~~~~~~~~~~~~~~
Application Developer Guide
~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. toctree::
:maxdepth: 1
step-by-step/step_by_step
exec_plan
hot_packages
murano_pl

View File

@ -84,11 +84,11 @@ Application package could be composed manually. Follow the 5 steps below.
`Browse` page looks like:
.. image:: ../figures/chef_server.png
.. image:: figures/chef_server.png
The configuration form, where you can enter template parameters, will be generated automatically and looks as follows:
.. image:: ../figures/chef_server_form.png
.. image:: figures/chef_server_form.png
After filling the form the application is ready to be deployed.

View File

@ -38,4 +38,4 @@ The application package root folder should contain the following:
Here is the visual representation of the Murano application
package structure:
.. image:: ../../figures/structure.png
.. image:: ../figures/structure.png

View File

@ -8,47 +8,4 @@ Appendix
tutorials
rest_api_spec
cli_ref
glossary
Miscellaneous
~~~~~~~~~~~~~
**Background Concepts for Murano**
.. toctree::
:maxdepth: 1
articles/workflow
**Tutorials**
.. toctree::
:maxdepth: 1
image_builders/index
articles/test_docs
**Guidelines**
.. toctree::
:maxdepth: 1
contributing
guidelines
**Gerrit review dashboard**
.. toctree::
:maxdepth: 1
murano_gerrit_dashboard
**API specification**
.. toctree::
:maxdepth: 1
specification/index
glossary

View File

@ -0,0 +1,42 @@
Miscellaneous
~~~~~~~~~~~~~
**Background Concepts for Murano**
.. toctree::
:maxdepth: 1
workflow
**Tutorials**
.. toctree::
:maxdepth: 1
image_builders/index
test_docs
**Guidelines**
.. toctree::
:maxdepth: 1
contributing
guidelines
**Gerrit review dashboard**
.. toctree::
:maxdepth: 1
murano_gerrit_dashboard
**API specification**
.. toctree::
:maxdepth: 1
specification/index

View File

@ -0,0 +1 @@
.. include:: ../../../../CONTRIBUTING.rst

View File

@ -0,0 +1,11 @@
===========================
Murano API v1 specification
===========================
.. toctree::
:maxdepth: 1
overview
murano-api
murano-repository
murano-env-temp

View File

@ -1,7 +1,3 @@
===========================
Murano API v1 specification
===========================
General information
===================
@ -42,9 +38,4 @@ General information
All requests include a keystone authentication token header
(X-Auth-Token). Clients must authenticate with keystone before
interacting with the murano service.
.. include:: murano-api.rst
.. include:: murano-repository.rst
.. include:: murano-env-temp.rst
interacting with the murano service.

View File

@ -1 +0,0 @@
.. include:: ../../../CONTRIBUTING.rst

View File

@ -2,7 +2,7 @@
.. _contributor-guide:
Contributor guide
Contributor Guide
~~~~~~~~~~~~~~~~~
.. toctree::

View File

@ -1,7 +1,7 @@
.. _quickstart:
==========
Quickstart
QuickStart
==========
This is a brief walkthrough to quickly get you familiar with the basic

View File

@ -1,6 +1,6 @@
.. _user-guide:
User guide
User Guide
~~~~~~~~~~
.. toctree::

View File

@ -62,8 +62,8 @@ client.
administrator-guide/admin_index
Developer Documentation
~~~~~~~~~~~~~~~~~~~~~~~
Application Developer Documentation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Learn how to compose an application package and get it ready for uploading to
Murano.
@ -71,8 +71,7 @@ Murano.
.. toctree::
:maxdepth: 1
appdev-guide/step-by-step/step_by_step
appdev-guide/developerguide/developer_index
appdev-guide/developer_index
appdev-guide/faq
Contributor Documentation
@ -91,4 +90,5 @@ Other Documentation
.. toctree::
:maxdepth: 1
appendix/appendix_index
appendix/appendix_index
appendix/articles/articles_index