Jump to: navigation, search

Difference between revisions of "Documentation/ContentSpecs"

m (Guides for contributors)
(Guides for contributors)
Line 45: Line 45:
 
== Guides for contributors ==
 
== Guides for contributors ==
  
* [http://docs.openstack.org/infra/manual/ Infrastructure User Manual]: Reference documentation for tools and processes used for all contributors to OpenStack projects. It includes instructions on how to create all the necessary accounts, setup development environment, use gerrit review workflow. The manual also covers more advanced topics, like how to create new git repositories and setup third-party continuous integration systems.
+
* [http://docs.openstack.org/infra/manual/ Infrastructure User Manual]: Reference documentation for tools and processes used for all contributors to OpenStack projects. It includes instructions on how to create all the necessary accounts, setup development environment, use gerrit review workflow. The manual also covers more advanced topics, like how to create new git repositories. The manual is maintained by the OpenStack Infrastructure team.
  
 
----
 
----
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Revision as of 12:36, 2 January 2015

Release specific documentation

The Installation Guides and Configuration Reference are released at release time, with draft material published to docs.openstack.org/trunk/. The rest of the guides are continuously released.

Installation Guides

The OpenStack Installation Guides describe a manual install process, as in, by hand, no automation, for multiple distributions based on packaging system:

Guides for deployers and administrators

OpenStack Configuration Reference: Contains a reference listing of all configuration options for core and integrated OpenStack services by release version.

Continously released documentation

These guides cover multiple versions and we follow the general release information. The guides cover thus the latest two versions, for example Icehouse and Havana. The following exceptions apply:

  • Operations Guide: Icehouse target, revised specifically to target that release
  • Security Guide: written prior to Havana release
  • HA Guide: updated last at Havana timeframe, still needs updates

Guides for deployers and administrators

Guides for end users

  • OpenStack End User Guide: Shows OpenStack end users how to create and manage resources in an OpenStack cloud with the OpenStack dashboard and OpenStack client commands.
  • OpenStack Admin User Guide: Shows OpenStack administrators how to create and manage resources in an OpenStack cloud with the OpenStack dashboard and OpenStack client commands.
  • OpenStack API Quick Start: A brief overview of how to send REST API requests to endpoints for OpenStack services.
  • Command-Line Interface Reference: Automatically generates help text for CLI commands and subcommands.

API documentation

Guides for contributors

  • Infrastructure User Manual: Reference documentation for tools and processes used for all contributors to OpenStack projects. It includes instructions on how to create all the necessary accounts, setup development environment, use gerrit review workflow. The manual also covers more advanced topics, like how to create new git repositories. The manual is maintained by the OpenStack Infrastructure team.