Documentation/Checklist
Contents
Documentation checklist
Work-in-progress
When you write documentation, use this checklist to ensure quality.
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 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. | |
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. |
Official book titles and title abbreviations
Installation guides
Audience: Cloud operators
Title | Title abbreviation |
---|---|
OpenStack Basic Installation Guide for Ubuntu 12.04 (LTS) and Debian Wheezy | Basic Install Guide for Ubuntu 12.04 |
OpenStack Basic Installation Guide for Fedora 18 | Basic Install Guide for Fedora 18 |
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 12.04 |
Administration guides
Audience: Cloud operators
Title | Title abbreviation |
---|---|
OpenStack Block Storage Service Administration Guide | Block Storage Service Admin Guide |
OpenStack Compute Administration Guide | Compute Admin Guide |
OpenStack Networking Administration Guide | Networking Admin Guide |
OpenStack Object Storage Administration Guide | Object Storage Admin Guide |
OpenStack Operations Guide | Ops Guide |
OpenStack High Availability Guide | High Availability Guide |
OpenStack Virtual Machine Image Guide | Virtual Machine Image Guide |
OpenStack Configuration Reference (in the works) | 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
Titles:
- API Quick Start
- Compute API Developer Guide for Shell and Python
- Clients Guide (moving into the new User Guide)
- API Complete Reference (web page)
- Block Storage Service API v2 Reference
- Compute API v2 and Extensions Reference
- Identity Service API v2.0 Reference
- Image Service API v2 Reference
- Networking API v2.0 Reference
- Image Service API v1 Reference
- Object Storage API v1 Reference
- User Guide (title might change)
- Admin User Guide (TBD)