<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Aug 26, 2016 at 7:46 AM, Bashmakov, Alexander <span dir="ltr"><<a href="mailto:alexander.bashmakov@intel.com" target="_blank">alexander.bashmakov@intel.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Any more feedback on this?<br></blockquote><div><br></div><div>Hi, I've added a comment on the review. For now, inline text descriptions are best for the context of what you're adding in that particular place.</div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="HOEnZb"><div class="h5"><br>
> On Aug 18, 2016, at 10:30 AM, Bashmakov, Alexander <<a href="mailto:alexander.bashmakov@intel.com">alexander.bashmakov@intel.com</a><wbr>> wrote:<br>
><br>
> Concrete example of an api-ref difference between Mitaka and Newton:<br>
> <a href="https://review.openstack.org/#/c/356693/1/api-ref/source/v2/images-parameters.yaml" rel="noreferrer" target="_blank">https://review.openstack.org/#<wbr>/c/356693/1/api-ref/source/v2/<wbr>images-parameters.yaml</a><br>
><br>
> -----Original Message-----<br>
> From: Sean Dague [mailto:<a href="mailto:sean@dague.net">sean@dague.net</a>]<br>
> Sent: Thursday, August 18, 2016 10:20 AM<br>
> To: Nikhil Komawar <<a href="mailto:nik.komawar@gmail.com">nik.komawar@gmail.com</a>>; OpenStack Development Mailing List (not for usage questions) <<a href="mailto:openstack-dev@lists.openstack.org">openstack-dev@lists.<wbr>openstack.org</a>><br>
> Subject: Re: [openstack-dev] [all] versioning the api-ref?<br>
><br>
>> On 08/18/2016 11:57 AM, Nikhil Komawar wrote:<br>
>> I guess the intent was to indicate the need for indicating the micro<br>
>> or in case of Glance minor version bump when required.<br>
>><br>
>> The API isn't drastically different, there are new and old elements as<br>
>> shown in the Nova api ref linked.<br>
><br>
> Right, so the point is that it should all be describable in a single document. It's like the fact that when you go to python API docs you get things like - <a href="https://docs.python.org/2/library/wsgiref.html" rel="noreferrer" target="_blank">https://docs.python.org/2/<wbr>library/wsgiref.html</a><br>
><br>
> "New in version 2.5."<br>
><br>
> Perhaps if there is a concrete example of the expected differences between what would be in the mitaka tree vs. newton tree was can figure out an appropriate way to express that in api-ref.<br>
><br>
>    -Sean<br>
><br>
> --<br>
> Sean Dague<br>
> <a href="http://dague.net" rel="noreferrer" target="_blank">http://dague.net</a><br>
><br>
> ______________________________<wbr>______________________________<wbr>______________<br>
> OpenStack Development Mailing List (not for usage questions)<br>
> Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.<wbr>openstack.org?subject:<wbr>unsubscribe</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-dev</a><br>
><br>
> ______________________________<wbr>______________________________<wbr>______________<br>
> OpenStack Development Mailing List (not for usage questions)<br>
> Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.<wbr>openstack.org?subject:<wbr>unsubscribe</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-dev</a><br>
<br>
______________________________<wbr>______________________________<wbr>______________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.<wbr>openstack.org?subject:<wbr>unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-dev</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Anne Gentle</div><div><a href="http://www.justwriteclick.com" style="font-size:12.8px" target="_blank">www.justwriteclick.com</a><br></div></div></div></div></div>
</div></div>