[openstack-dev] Adding "not docs" banner to specs website?

Amy Marrich amy at demarco.com
Mon Mar 19 15:04:45 UTC 2018


I think it's a good idea especially as some times a spec is never completed
or not in the same release.

Thanks,

Amy(spotz)

On Mon, Mar 19, 2018 at 9:57 AM, Jim Rollenhagen <jim at jimrollenhagen.com>
wrote:

> Ironic (and surely other projects) have had to point out many times that
> specs are a point in time design discussion, and not completed
> documentation. It's obviously too much work to go back and update specs
> constantly.
>
> What do folks think about a banner at the top of the specs website (or
> each individual spec) that points this out? I'm happy to do the work if we
> agree it's a good thing to do. My suggested wording:
>
> "NOTE: specifications are a point-in-time design reference, not up-to-date
> feature documentation."
>
> // jim
>
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20180319/ac787610/attachment.html>


More information about the OpenStack-dev mailing list