[openstack-dev] [Keystone] What to do with Specs after they are approved?

Anne Gentle anne at openstack.org
Fri Aug 15 20:28:35 UTC 2014


On Fri, Aug 15, 2014 at 3:11 PM, Dolph Mathews <dolph.mathews at gmail.com>
wrote:

> Regarding the connection to release notes, it'd be useful to link from
> official release note bullet points back to the corresponding spec on
> specs.openstack.org to provide additional detail.
>
>
I disagree, the people reading release notes are not the audience for
specs. Please point to deployer docs or user docs.


>
> On Fri, Aug 15, 2014 at 2:58 PM, Anne Gentle <anne at openstack.org> wrote:
>
>>
>>
>>
>> On Fri, Aug 15, 2014 at 2:47 PM, Adam Young <ayoung at redhat.com> wrote:
>>
>>> We are putting a lot of effort into the Specs process.  It seems like a
>>> pity to let them go to waste after the features they describe are
>>> implemented.  Ideally, they should be part of the official documentation.
>>> Many are too detailed to be a release note.
>>>
>>> Should they be part of the patch, and put under keystone[*]/docs? Is
>>> there a better place for them to live?
>>>
>>>
>> They are very purposefully not docs - they are ideas that may or may not
>> be fully implemented any given release. That's why we stood up
>> specs.openstack.org.
>>
>>
>>> _______________________________________________
>>> OpenStack-dev mailing list
>>> OpenStack-dev at lists.openstack.org
>>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>>>
>>
>>
>> _______________________________________________
>> OpenStack-dev mailing list
>> OpenStack-dev at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>>
>>
>
> _______________________________________________
> OpenStack-dev mailing list
> OpenStack-dev at lists.openstack.org
> 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/20140815/4fc69b64/attachment.html>


More information about the OpenStack-dev mailing list