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

Jim Rollenhagen jim at jimrollenhagen.com
Mon Mar 19 14:57:58 UTC 2018


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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20180319/abd7a36b/attachment.html>


More information about the OpenStack-dev mailing list