openstack-manuals/doc/contributor-guide/source/quickstart/new-projects.rst
Lana Brindley 7c34ce5d69 Reorganised Quickstart chapter
Reorganised to add quickstart info for developers and new big tent
projects.

Change-Id: I698a49ff1628349d372f91136b2829be5f8c2ebc
Closes-Bug: #1553873
Depends-On: I72a7d57ae49ed2123475d3d1051c630e7b69dcaf
2016-03-22 05:42:11 +00:00

1.4 KiB

New projects

If you are maintaining a new project that has recently been accepted into the OpenStack 'big tent' then you will require some documentation for your project.

Developer documentation for your project should live in your project's git repository, and be published to docs.openstack.org/developer/yourproject. If you need to create that index page, send a patch to the openstack-manuals team. You will also need to add the openstack-server-publish job to the appropriate repositories so that the index page is re-published with every commit.

Any configuration options or command line tools should be documented using the automated openstack-doc-tools. For more information about these automated tools, see the doc-tools chapter.

To create your Installation documentation in accordance with the OpenStack Foundation Project Navigator, begin by drafting and polishing it in your developer documentation repository. This is considered 'official' Installation documentation for the purposes of the Navigator. Once you have a good amount of quality content, open a conversation with the openstack-manuals team about inclusion in the top level documentation directory. The docs team will then be able to work with you to determine your specific documentation needs, and the best way to include your project in openstack-manuals.