Governance tag documentation guidelines

Important

As of the Pike release, these guidelines are now out of date and do not cover the new documentation scope.

An revision is forthcoming.

The docs:follows-policy tag indicates that the OpenStack Documentation team and the project team associated with the tagged deliverable verify that the project’s documentation in the openstack-manuals repository is accurate and current.

Definition

This tag indicates that a deliverable’s documentation set is prepared in coordination with the OpenStack Documentation team following their defined practices and policies for review and verification. It does not indicate that the documentation team has taken ownership of producing the documentation for the deliverable.

To maintain the docs:follows-policy tag, the documentation cross-project liaison (CPL) or project technical lead (PTL) must have read the documentation relevant to their project and opened any appropriate bug reports, providing information to the docs team on how to document these issues.

For details, see docs:follows-policy.

Guidelines

The documentation review deadline coincides with feature freeze. See the OpenStack release schedule.

6 weeks before release

The liaison has made the docs team aware of all major new features and bug fixes up till this point.

The project team either:

  • provides sufficient information to the documentation team in a bug report to ensure the bug or enhancement is documented appropriately

or

  • provides a fix to the openstack-manuals repo. If patch is submitted, this action would require an additional +1 by the relevant project team for such issues before approval.

4 weeks before release

The project team ensures that the liaison has reviewed the documentation for the team project and either:

  • provides sufficient information to the documentation team in a bug report to ensure the bug or enhancement is documented appropriately

or

  • provides a fix to the openstack-manuals repo. If patch is submitted, this action would require an additional +1 by the relevant project team for such issues before approval.

2 weeks before release

The CPL works alongside the documentation release team to test installation instructions and complete the release testing matrix (for example, see the Ocata release testing matrix). It is recommended that the liaison tests the instructions for at least one distribution.