Jump to: navigation, search

Difference between revisions of "Documentation/ContentSpecs"

(Release specific documentation)
(Replaced content with "Read the new content in the [http://docs.openstack.org/contributor-guide/docs-builds.html Documentation Contributors Guide]. {{OpenStack_Documentation_Navbar}} ---- Ca...")
Line 1: Line 1:
 +
Read the new content in the [http://docs.openstack.org/contributor-guide/docs-builds.html Documentation Contributors Guide].
 +
 
{{OpenStack_Documentation_Navbar}}
 
{{OpenStack_Documentation_Navbar}}
  
= Release specific documentation =
 
 
The Installation Guides and Configuration Reference are released at release time, with draft material published to http://docs.openstack.org/draft/draft-index.html. 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:
 
* [Installation Guide for Debian 7.0] - needs a plan to be published
 
* [http://docs.openstack.org/kilo/install-guide/install/zypper/content/ Installation Guide for openSUSE and SUSE Linux Enterprise Server]
 
* [http://docs.openstack.org/kilo/install-guide/install/yum/content/ Installation Guide for Red Hat Enterprise Linux, CentOS, and Fedora]
 
* [http://docs.openstack.org/kilo/install-guide/install/apt/content/ Installation Guide for Ubuntu 12.04 and 14.04 (LTS) Server]
 
 
Source: [https://git.openstack.org/cgit/openstack/openstack-manuals] openstack/openstack-manuals
 
 
== Guides for deployers and administrators ==
 
[http://docs.openstack.org/draft/config-reference/content/  OpenStack Configuration Reference]: Contains a reference listing of all configuration options for core and integrated OpenStack services by release version.
 
 
Source: [https://git.openstack.org/cgit/openstack/openstack-manuals] openstack/openstack-manuals and using openstack-doc-tools to scrape the code for configuration reference information
 
 
= Continuously released documentation =
 
 
These guides cover multiple versions and we follow the general [[Releases|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 ==
 
 
* [http://docs.openstack.org/arch-design/content OpenStack Architecture Design Guide]: Contains information on how to plan, design and architect an OpenStack cloud.
 
* [http://docs.openstack.org/admin-guide-cloud/content/ OpenStack Cloud Administrator Guide]: Contains how-to information for managing an OpenStack cloud as needed for your use cases, such as storage, computing, or software-defined-networking.
 
* [http://docs.openstack.org/high-availability-guide/content/index.html OpenStack High Availability Guide]: Describes potential strategies for making your OpenStack services and related controllers and data stores highly available.
 
* [http://docs.openstack.org/sec/ OpenStack Security Guide]: Provide best practices and conceptual information about securing an OpenStack cloud.
 
* [http://docs.openstack.org/image-guide/content/ Virtual Machine Image Guide]: Shows you how to obtain, create, and modify virtual machine images that are compatible with OpenStack.
 
 
== Guides for end users ==
 
 
* [http://docs.openstack.org/user-guide/content/ 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.
 
* [http://docs.openstack.org/user-guide-admin/content/ 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.
 
* [http://docs.openstack.org/api/quick-start/content/ OpenStack API Quick Start]: A brief overview of how to send REST API requests to endpoints for OpenStack services.
 
*  [http://docs.openstack.org/cli-reference/content/ Command-Line Interface Reference]: Automatically generates help text for CLI commands and subcommands.
 
 
== API documentation ==
 
 
* [http://developer.openstack.org/api-ref.html Complete API Reference]: Complete reference listing of OpenStack REST APIs with example requests and responses. 
 
* [http://specs.openstack.org API specifications]: Within project's specification repos, some have opted to document API specifications, such as Identity.
 
* [http://docs.openstack.org/developer/swift/#object-storage-v1-rest-api-documentation Object Storage API v1]
 
* [http://developer.openstack.org/firstapp-libcloud/getting_started.html] Writing your first OpenStack application
 
 
== 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. The manual is maintained by the OpenStack Infrastructure team.
 
 
== Licenses ==
 
 
This section shows the license indicators as of March 20, 2015.
 
 
* OpenStack Architecture Design Guide: Apache 2.0 and CC-by-sa 3.0
 
* OpenStack Cloud Administrator Guide: Apache 2.0 and CC-by-sa 3.0
 
 
* OpenStack Install Guides (all): Apache 2.0
 
* OpenStack High Availability Guide: Apache 2.0
 
* OpenStack Configuration Reference: Apache 2.0
 
 
* OpenStack Security Guide: CC-by 3.0
 
* Virtual Machine Image Guide: CC-by 3.0
 
* OpenStack Operations Guide: CC-by 3.0
 
* OpenStack End User Guide: CC-by 3.0
 
* OpenStack Admin User Guide: CC-by 3.0
 
* Command-Line Interface Reference: CC-by 3.0
 
 
* Contributor dev docs (docs.openstack.org/developer/<projectname>): none indicated in output; Apache 2.0 in repo
 
* OpenStack API Quick Start: none indicated in output; Apache 2.0 in repo
 
* API Complete Reference: none indicated in output; Apache 2.0 in repo
 
 
*  Infrastructure User Manual: none indicated in output; CC-by 3.0 in repo
 
 
What to do to make more consistent output:
 
 
* OpenStack Architecture Design Guide: Apache 2.0 and CC-by 3.0
 
* OpenStack Cloud Administrator Guide: Apache 2.0 and CC-by 3.0
 
* OpenStack Install Guides (all): Apache 2.0 and CC-by 3.0
 
* OpenStack High Availability Guide: Apache 2.0 and CC-by 3.0
 
* OpenStack Security Guide: CC-by 3.0
 
* Virtual Machine Image Guide: CC-by 3.0
 
* OpenStack Operations Guide: CC-by 3.0
 
* OpenStack End User Guide: CC-by 3.0
 
* OpenStack Admin User Guide: CC-by 3.0
 
 
These guides are created by "scraping" code:
 
 
* OpenStack Configuration Reference: Apache 2.0 and CC-by 3.0
 
* Command-Line Interface Reference: Apache 2.0 and CC-by 3.0
 
 
These guides have no indicator in output:
 
 
* Contributor dev docs (docs.openstack.org/developer/<projectname>): none indicated in output; Apache 2.0 in repo
 
* OpenStack API Quick Start: none indicated in output; Apache 2.0 in repo
 
* API Complete Reference: none indicated in output; Apache 2.0 in repo
 
 
This guide has a review in place to get a license indicator in output:
 
 
*  Infrastructure User Manual: none indicated in output; CC-by 3.0 in repo
 
 
----
 
----
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Revision as of 19:14, 26 October 2015

Read the new content in the Documentation Contributors Guide.