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

Jeremy Stanley fungi at yuggoth.org
Fri Jul 28 19:39:25 UTC 2017


On 2017-07-28 15:32:01 -0400 (-0400), David Desrosiers wrote:
[...]
> I am very opposed to removing subsets of docs, including the install guide,
> after the release goes eol upstream from consumers for exactly that reason.
> 
> Watermarking the upstream docs with series and version should reduce or
> eliminate the need for people to incorrectly submit fixes, patches and PRs
> for eol releases that the core team can no longer support, but that
> shouldn't necessitate removal of the installation instructions.

Perhaps a compromise is to add very visible banners that explicitly
remind the reader they're looking at installation instructions for
an outdated version of the software, with a link to see the current
installation instructions instead? Simply relying on newcomers to
recognize release series names and inherently know whether they're
reading the latest version is an issue.
-- 
Jeremy Stanley
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 949 bytes
Desc: Digital signature
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20170728/23b84184/attachment.sig>


More information about the OpenStack-dev mailing list