[Openstack-docs] Clearly marking trunk/ as the unstable version

Matt Kassawara mkassawara at gmail.com
Mon Jul 7 15:53:53 UTC 2014


I think we should watermark all documents that reference a particular
release to make the version more obvious to people who jump into our
content from search engines.


On Fri, Jul 4, 2014 at 3:53 AM, Andreas Jaeger <aj at suse.com> wrote:

> On 06/20/2014 09:13 AM, Gauvain Pocentek wrote:
> > We've received several bug reports about the auth_strategy nova option
> > missing from our install procedure these last few days. These bugs are
> > reported against the trunk doc, by people installing icehouse. The doc
> > is in fact correct, both in trunk (the default for this option in juno
> > has changed and we don't need to set it anymore), and in the icehouse
> > branch (where the option is set up in the procedure).
> >
> > Would it be possible to mark the pages in the trunk/ subdirectory of
> > docs.o.org as "in progress" or "unstable", or anything that would
> > explicitly tell the user that he might not be reading the correct page?
> > We already have "juno" in the install-guide and config-ref titles, but I
> > don't think it's visible enough.
>
> Proposed patch:
> https://review.openstack.org/104789
>
> Output:
>
> http://docs-draft.openstack.org/89/104789/1/check/gate-openstack-manuals-tox-doc-publish-checkbuild/645c1fa/publish-docs/
>
> This is using the clouddocs-maven options of adding a watermark,
>
> Andreas
> --
>  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
>   SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>    GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
>     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140707/0c387bbc/attachment.html>


More information about the Openstack-docs mailing list