As of the time of drafting, the docs.openstack.org site retention policy is to publish the current release (Newton), plus two previous releases (Mitaka and Liberty). The retention policy was initially designed to match the “End of Life” support policy that project branches adhere to, which is documented as indicating stable branches (see References). Because the project code would not be supported, the docs were removed from the docs site, to match the project code branch strategy.
According to the last User Survey (see References), 9% of production OpenStack installations were still running Icehouse, 17% were running Juno, and 40% were running Kilo.
This would indicate that a significant number of users are relying on documentation that could potentially disappear in accordance with our current retention policy.
Historical note: When the documentation pages were created in 2010, they were hosted on Rackspace Cloud Sites without a clear retention policy, which resulted in a large number of unmanaged files over many years. The docs.o.o site was the largest site on Cloud Sites at the time, which resulted in Cloud Sites specifically asking us to remove old content. Change in hosting provider was eventually enforced on the team by the sale of Cloud Sites to Liquid Web in 2016, and the site is now hosted on internal OpenStack infrastructure, and the current retention policy was decided upon at the Barcelona Summit in October 2016.
Testing will follow the standard documentation review process.
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.