|
|
(5 intermediate revisions by the same user not shown) |
Line 1: |
Line 1: |
− | {{OpenStack_Documentation_Navbar}}
| + | #REDIRECT [[Documentation/Structure]] |
− | | |
− | == Documentation checklist ==
| |
− | '''<big>Work-in-progress</big>'''<br />
| |
− | | |
− | When you write documentation, use this checklist to ensure quality.
| |
− | | |
− | {| class="wikitable"
| |
− | |-
| |
− | ! Task !! Description !! Complete?
| |
− | |-
| |
− | | pom.xml file || Your pom.xml file uses the latest (non-SNAPSHOT) cloud-doc plugin version and is configured correctly. To find the version number of the latest plugin, go to [https://github.com/rackerlabs/clouddocs-maven-plugin#release-notes Clouddocs Maven Plugin Release Notes]. See notes for version 1.7.1 for information about new pom.xml file configuration directives. ||
| |
− | |-
| |
− | | TOC || Your pom.xml file configures a TOC for your book. ||
| |
− | |-
| |
− | | Spellcheck || Oxygen has a spellchecker. You can spellcheck all files in a book by choosing '''Edit''' > '''Check Spelling in Files'''. ||
| |
− | |-
| |
− | | Glossary || Embed the shared glossary and mark terms with the <glossterm> tag in your document. ||
| |
− | |-
| |
− | | [[Documentation/Conventions|Doc conventions]] || Your content uses the recommended doc tagging. ||
| |
− | |-
| |
− | | Preface || Your book has a preface. ||
| |
− | |-
| |
− | | Doc history || The preface includes the doc history. Also make sure that you have included a revision entry for your latest changes. ||
| |
− | |-
| |
− | | Title || Title is correct. Look below for the official titles. ||
| |
− | |-
| |
− | | Code samples || Code samples are in separate files and included in chapter, section, or appendix file. ||
| |
− | |-
| |
− | | Chunking || Chapters and appendices are in separate files and included in the book file. ||
| |
− | |-
| |
− | | Source file names || Source file names use file naming conventions. Book files = bk_*; Chapter files = ch_*; Appendix files = app_*; Section files = section_*. ||
| |
− | | |
− | | |
− | |}
| |
− | | |
− | == Official book titles and title abbreviations ==
| |
− | | |
− | The titles are for the HTML and PDF outputs. The title abbreviations are for the PDF output only.
| |
− | | |
− | === Installation guides ===
| |
− | | |
− | '''Audience:''' Cloud operators
| |
− | {| class="wikitable"
| |
− | |-
| |
− | ! Title !! Title abbreviation
| |
− | |-
| |
− | | OpenStack Installation Guide for Debian 7.0 || Install Guide for Debian
| |
− | |-
| |
− | | OpenStack Installation Guide for openSUSE and SUSE Linux Enterprise Server || Install Guide for openSUSE and SUSE Linux Enterprise
| |
− | |-
| |
− | | OpenStack Installation Guide for Red Hat Enterprise Linux, CentOS, and Fedora || Install Guide for Red Hat
| |
− | |-
| |
− | | OpenStack Installation Guide for Ubuntu 12.04 (LTS) || Install Guide for Ubuntu
| |
− | |}
| |
− | | |
− | === Administration guides ===
| |
− | | |
− | '''Audience:''' Cloud operators
| |
− | {| class="wikitable"
| |
− | |-
| |
− | ! Title !! Title abbreviation
| |
− | |-
| |
− | | OpenStack Operations Guide || Ops Guide
| |
− | |-
| |
− | | OpenStack High Availability Guide || High Availability Guide
| |
− | |-
| |
− | | OpenStack Virtual Machine Image Guide || VM Image Guide
| |
− | |-
| |
− | | OpenStack Cloud Administrator Guide || Cloud Administrator Guide
| |
− | |-
| |
− | | OpenStack Configuration Reference || Config Reference
| |
− | |-
| |
− | |}
| |
− | | |
− | === Application developer and user guides ===
| |
− | | |
− | '''Audiences:'''
| |
− | * Developers who build applications that run in the cloud
| |
− | * Users who manage resources and services in the cloud<br />
| |
− | | |
− | '''Note:'''
| |
− | | |
− | The product definition in the pom.xml file affects the way the title breaks on the cover page in the PDF.
| |
− | | |
− | '''Titles:'''
| |
− | {| class="wikitable"
| |
− | |-
| |
− | ! Title !! Title abbreviation !! Product
| |
− | |-
| |
− | | API Quick Start || N/A ||
| |
− | |-
| |
− | | OpenStack API Complete Reference (web page) || N/A || OpenStack
| |
− | |-
| |
− | | OpenStack Block Storage Service API v2 Reference || Block Storage Service API Reference || OpenStack Block Storage Service
| |
− | |-
| |
− | | OpenStack Compute API v2 and Extensions Reference || Compute API and Extensions Reference || OpenStack Compute
| |
− | |-
| |
− | | OpenStack Identity Service API v2.0 Reference || Identity Service API Reference || OpenStack Identity Service
| |
− | |-
| |
− | | OpenStack Image Service API v2 Reference || Image Service API Reference || OpenStack Image Service
| |
− | |-
| |
− | | OpenStack Networking API v2.0 Reference || Networking API Reference || OpenStack Networking
| |
− | |-
| |
− | | OpenStack Image Service API v1 Reference || Image Service API Reference || OpenStack Image Service
| |
− | |-
| |
− | | Object Storage API v1 Reference || Object Storage API Reference || OpenStack Object Storage
| |
− | |-
| |
− | | OpenStack End User Guide || End User Guide || OpenStack
| |
− | |-
| |
− | | OpenStack Admin User Guide || Admin User Guide || OpenStack
| |
− | |-
| |
− | | OpenStack Command Line Interface Reference || CLI Reference|| OpenStack
| |
− | |}
| |
− | | |
− | ----
| |
− | [[Category:Documentation]]
| |