[openstack-dev] [docs][release][stable][ptl][infra] Strategic discussion regarding the future of documentation for EOL releases

Tony Breeds tony at bakeyournoodle.com
Thu Aug 3 02:20:24 UTC 2017


On Thu, Jul 27, 2017 at 07:05:16PM -0400, Doug Hellmann wrote:
 
> That content will now live in the project trees. Perhaps part of marking
> branches in those repos EOL needs to include deleting the install tree
> from the docs? Now that the docs are in a standard location, that could
> be part of an EOL script (although it means 2 phases, since we have to
> land the patch and let the docs rebuild before we remove the branch).

That can be done.  It's a bit of a pain but for the most part the gate
is pretty stable at EOL time.  I do worry about what we do if $projects
gate is broken and can't generate/publish the docs.
 
> We could also update the openstack-manuals tree to not publish links
> to the install guides (either removing the page or replacing it
> with a placeholder that explains they should be trying to use a
> newer version).

That'd work too.  I kinda like that option better.

Yours Tony.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 488 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20170803/ebd72157/attachment.sig>


More information about the OpenStack-dev mailing list