|
|
(38 intermediate revisions by 2 users not shown) |
Line 1: |
Line 1: |
− | == Documentation checklist ==
| + | #REDIRECT [[Documentation/Structure]] |
− | '''<big>Work-in-progress</big>'''<br />
| |
− | | |
− | When you write documentation, use this checklist to ensure quality.
| |
− | | |
− | {| class="wikitable"
| |
− | |-
| |
− | ! Task !! Description !! Complete?
| |
− | |-
| |
− | | pom.xml file || Make sure that your pom.xml file uses the latest cloud-doc plugin and is configured correctly. ||
| |
− | |-
| |
− | | Spellcheck || Oxygen has a spellchecker. You can spellcheck all files in a book by choosing ||
| |
− | |-
| |
− | | Glossary || Embed the shared glossary and mark terms with the <glossterm> tag in your document. ||
| |
− | |-
| |
− | | Doc conventions || Ensure that your content uses the recommended doc tagging. ||
| |
− | |-
| |
− | | Preface || Make sure the book has a preface. ||
| |
− | |-
| |
− | | Doc history || Make sure the preface includes the doc history. Also make sure that you have included a revision entry for your latest changes. ||
| |
− | |-
| |
− | | Title || Is the title correct? Look below for the official titles. ||
| |
− | |-
| |
− | | Code samples || Make sure code samples are in separate files. ||
| |
− | |-
| |
− | | Example || Example || Example
| |
− | |-
| |
− | | Example || Example || Example
| |
− | |}
| |
− | == Official book titles ==
| |
− | === Installation guides ===
| |
− | * Basic Installation Guide for Ubuntu 12.04 (LTS) and Debian Wheezy
| |
− | * Basic Installation Guide for Fedora 18
| |
− | * Installation Guide for Red Hat Enterprise Linux, CentOS, and Fedora
| |
− | * Installation Guide for Ubuntu 12.04 (LTS)
| |
− | | |
− | === Administration guides ===
| |
− | * Block Storage Service Administration Guide
| |
− | * Compute Administration Guide
| |
− | * Networking Administration Guide
| |
− | * Object Storage Administration Guide
| |
− | * Operations Guide
| |
− | * High Availability Guide
| |
− | * Virtual Machine Image Guide
| |
− | | |
− | === Application developer guides ===
| |
− | * 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)
| |