Below is a starting point. This needs to be modified for Apache CloudStack 4.0.
The time available before the release is short.
The following sections describe the information products for this release.
Update for new features. The following table lists the new features and how they affect documentation.
We are committed to provide documentation for features marked P1 and P2.
P1
LOE: Large
Writer: Radhika
SME: Alena P, Anthony, Chiradeep
Affects: Install, Admin docs
FS: http://wiki.cloudstack.org/display/RelOps/Inter-VLAN+Routing+functional+spec
PM: http://wiki.cloudstack.org/display/PM/Inter-VLAN+Routing
Test Plan:
P1
LOE: Unknown
Writer: Jessica
SME: Prachi, Chiradeep
Affects: Admin docs
FS: EC2 API support in CloudStack
S3 API in CloudStack
PM:
Test Plan:
P1
LOE: minor
Writer: Radhika
SME: Vijay, Kelven, Sateesh Chodapuneedi
Affects: Install docs
FS: Cisco Nexus 1000v Support in CloudStack - Functional Specification
Test Plan:
P1
LOE: Medium
Writer: Radhika
SME: Sheng Yang, Chiradeep
Affects: Admin docs
FS: Site-to-site VPN functional spec
PM: Site-to-Site VPN
Test Plan:
P2
Assign tag to any virtual resource in cloudstack.
Writer: Jessica
LOE: Small
SME: Alena P., Chiradeep
Affects: Admin docs
FS: Tags functional spec
PM: Tags
Test Plan:
P1
LOE: Medium
Writer: Radhika
SME: Ram Ganesh, Vijay Venkatachalam, Deepak Garg
Affects: Admin Doc
FS: http://wiki.cloudstack.org/display/DesignDocs/Auto+Scale+Feature
P1
LOE: Small
Writer: Jessica T
SME: Koushik Das
FS: Local storage for data volumes
LOE: Small
Writer: Jessica
SME: Alena P, Anthony, Chiradeep
Affects: Admin docs
FS: VM Tiers functional spec
PM: VM Tiers
Test Plan:
Mike Simos points out that some step-by-step procedures no longer match the current UI. Need to make a pass comparing all UI procedures in docs to current Burbank UI.
Writer: Radhika
Each new releases requires an update of the existing Installation Guide. A full rewrite should not be required, but some update is planned both for Doc Bugs and for the New Features table at the end of this plan.
Includes updated Upgrade steps, New Feature summaries, fixed and known issues, API change summary
Each new releases requires an update of the existing API Reference man pages. These are auto-generated and require only posting to the web.
It is assumed that bugs will be filed against documentation and some will be prioritized for this release. Currently known doc bugs per release can be obtained by querying Bugzilla. Triage of existing bugs is needed to determine which are required in this release. The goal is to address as many as possible of the bugs that reflect inaccuracies in the documentation. Enhancement requests can be targeted to a later release.
38 bugs are currently triaged as a definite "go" and further triage is needed to finalize this plan.
Move the Installation and Administration Guides from Microsoft Word to Docbook XML. WORK IN PROGRESS
Publican can output .po files which we can use to translate documentation into any desired language. DECISIONS REQUIRED:
In addition to the deliverables noted, the documentation team is engaged in addtional activities during this timeframe. These are not included in the Timeline section below, since they are not directly related to the release.