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

Doug Hellmann doug at doughellmann.com
Thu Aug 3 15:10:49 UTC 2017


Excerpts from Tony Breeds's message of 2017-08-03 12:20:24 +1000:
> 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.

Yes, that's easy to do with 1 patch to the openstack-manuals repo.

Doug



More information about the OpenStack-dev mailing list