
<html><body>

<p><tt><font size="2">Anne Gentle <annegentle@justwriteclick.com> wrote on 03/03/2015 01:42:50 PM:<br>

<br>

> From: Anne Gentle <annegentle@justwriteclick.com></font></tt><br>

<tt><font size="2">> To: Steven Kaufer/Rochester/IBM@IBMUS</font></tt><br>

<tt><font size="2">> Cc: "openstack-docs@lists.openstack.org" <openstack-docs@lists.openstack.org></font></tt><br>

<tt><font size="2">> Date: 03/03/2015 01:43 PM</font></tt><br>

<tt><font size="2">> Subject: Re: [OpenStack-docs] Standardizing pagination REST API <br>

> query string parameters</font></tt><br>

<tt><font size="2">> <br>

> <br>

> On Mar 3, 2015, at 12:48 PM, Steven Kaufer <kaufer@us.ibm.com> wrote:<br>

</font></tt><br>

<tt><font size="2">> I have proposed an addition to the REST API doc for cinder to add<br>

> sorting to the GET volumes queries [1]. While doing this work, I<br>

> noticed that the pagination parameters (eg, limit/marker) were<br>

> missing from the cinder documentation. I have looked at how the<br>

> other projects have documented this and I see that they are not<br>

> consistent.<br>

> <br>

...<br>

> <br>

> IMO, instead of adding yet another definition for the limit/marker<br>

> parameters for cinder, the definition of these parameters could be<br>

> made generic and shared across all projects.<br>

> <br>

> I see that there is no cross-project equivalent common.ent file. Any<br>

> thoughts or objections to creating one and then updating the above<br>

> projects to use it for limit and marker? Obviously the parameter<br>

> definitions needs to be made generic and we can use a gerrit review<br>

> to hash out those details.<br>

</font></tt><br>

<tt><font size="2">> <br>

> Sure, works for me! And like you say, we can figure out how to write<br>

> it generically in the review itself.</font></tt><br>

<tt><font size="2">> <br>

> Thanks for bringing it here for input. </font></tt><br>

<tt><font size="2">> Anne</font></tt><br>

<br>

<tt><font size="2">Thanks for the feedback Anne, the review is here:</font></tt><br>

<a href="https://review.openstack.org/#/c/161102"><tt><font size="2">https://review.openstack.org/#/c/161102</font></tt></a><br>

<br>

<tt><font size="2">Thanks,</font></tt><br>

<tt><font size="2">Steven Kaufer</font></tt><br>

<br>

<tt><font size="2">> Thanks for the feedback!<br>

> <br>

> [1] <a href="https://review.openstack.org/#/c/160550/">https://review.openstack.org/#/c/160550/</a><br>

> <br>

> Steven Kaufer</font></tt><br>

<tt><font size="2">> _______________________________________________<br>

> OpenStack-docs mailing list<br>

> OpenStack-docs@lists.openstack.org<br>

> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a></font></tt></body></html>