The recent OpenDev change changed a few URLs. Redirects are in place but let's use the new URLs everywhere: review.openstack.org moved to review.opendev.org, git hosting moved from git.openstack.org to opendev.org. Change-Id: I5cbcaed5a7ab0ab7994045a90e1a91e4a43c7611
3.1 KiB
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.