Jump to: navigation, search

Documentation

Revision as of 09:24, 2 February 2014 by Jaegerandi (talk | contribs)


Full name OpenStack Documentation
Code name none
Source code openstack-manuals; api-site
Bug tracker http://bugs.launchpad.net/openstack-manuals and http://bugs.launchpad.net/openstack-api-site
Blueprints http://blueprints.launchpad.net/openstack-manuals
Developer doc Documentation HowTo
Current PTL Anne Gentle
Meetings Documentation team meeting
Status Related
FAQ Documentation HowTo

Documentation is community-oriented and available for different audiences on several websites - this wiki is for project or release documentation, the developer documentation for the projects is on docs.openstack.org/developer for example. For official documentation, see docs.openstack.org. To log a bug against the documentation, go to http://bugs.launchpad.net/openstack-manuals or http://bugs.launchpad.net/openstack-api-site.

There's also an OpenStack documentation mailing list and IRC channel at #openstack-doc.

The Documentation Program Technical Lead (PTL) is Anne Gentle.

OpenStack documentation

OpenStack API reference and specifications

Published doc Source repository
API Reference https://github.com/openstack/api-site/tree/master/api-ref
Block Storage Service API v2 Reference https://github.com/openstack/volume-api/tree/master/v2
Block Storage Service API v1 Reference (N/A) https://github.com/openstack/volume-api/tree/master/v1
Compute API v2 and Extensions Reference https://github.com/openstack/compute-api
Identity Service API v2.0 Reference https://github.com/openstack/identity-api
Networking API v2.0 Reference https://github.com/openstack/netconn-api
Image Service API v2 Reference https://github.com/openstack/image-api/tree/master/openstack-image-service-api/src/markdown
Image Service API v1 Reference https://github.com/openstack/image-api/tree/master/openstack-image-service-api/src/docbkx
Object Storage API v1 Reference https://github.com/openstack/object-api

OpenStack administration and configuration guides

Published doc Source repository
Configuration Reference https://github.com/openstack/openstack-manuals/tree/master/doc/config-reference
Cloud Administrator Guide https://github.com/openstack/openstack-manuals/tree/master/doc/admin-guide-cloud
High Availability Guide https://github.com/openstack/openstack-manuals/tree/master/doc/high-availability-guide
Operations Guide https://github.com/openstack/operations-guide
Security Guide https://github.com/openstack/openstack-manuals/tree/master/doc/security-guide
Virtual Machine Image Guide https://github.com/openstack/openstack-manuals/tree/master/doc/image-guide

OpenStack installation guides

Published doc Source repository
Installation Guide for Debian 7.0 https://github.com/openstack/openstack-manuals/tree/master/doc/install-guide
Installation Guide for openSUSE and SUSE Linux Enterprise Server https://github.com/openstack/openstack-manuals/tree/master/doc/install-guide
Installation Guide for Red Hat Enterprise Linux, CentOS, and Fedora https://github.com/openstack/openstack-manuals/tree/master/doc/install-guide
Installation Guide for Ubuntu 12.04 (LTS) Server https://github.com/openstack/openstack-manuals/tree/master/doc/install-guide

OpenStack user guides

Published doc Source repository
API Quick Start https://github.com/openstack/api-site/tree/master/api-quick-start
End User Guide https://github.com/openstack/openstack-manuals/tree/master/doc/user-guide
Admin User Guide https://github.com/openstack/openstack-manuals/tree/master/doc/user-guide-admin

Source Repositories

Doc source is on GitHub. Everyone can propose merges to docs, see Documentation/HowTo. Here are the repositories that build to docs.openstack.org.

For a complete listing of which docs are built, including details about source and target locations, see Documentation/Builds.

Development

These guides are available and sourced in .rst files in /doc/source/ if you want to work on them:


Ideally the above content is geared towards developers.

The content at docs.openstack.org is for OpenStack administrators and application developers.

Releases

Lists current development release and past releases, with links to downloads and release notes (what's new and what's changed in each release as well as known issues and potential workarounds)

Support

How to find or ask for support.

Glossary

  • Glossary - Contains terms that are our definitions for OpenStack, cloud computing, and open source.

Project documentation

Development

How to contribute code to OpenStack or develop using the OpenStack projects.

Launchpad reference

How we use Launchpad to track features, bugs and releases.

Writing documentation