On Wed, 12 Oct 2016, McLellan, Steven wrote:
This issue came up during our meeting last week and it was suggested
to ask the API working group for its opinion, so any comments welcome.
If for whatever reason you don't get enough joy from the mailing
list, feel free to stick this topic on the agenda[1] and show up to
the meetings to talk about it. I'd hope in this case, however, that
email ought to suffice.
This obviously isn't life threatening, more of a convenience for a
number of people who's expressed frustration with getting the
parameter names wrong, but does anyone on the API WG have a strong
opinion against doing it?
If you've already established a commitment to elasticsearch and a
precedent for using some of its grammar for query strings I'd say
that _not_ doing it would be a mistake. What you've proposed in the
review (doing both but not allowing intermixing of the two styles).
makes sense to me.
[1] I am aware of the discussions around paging versus 'marker'-based
scrolling. We plan to add support for a more cursor-like method as
well, but Elasticsearch has always supported paging.
I think this is part of why the pagination guideline sort of stalled
out. In addition to the things you mentioned, it's also the case
that the concept of a page is broken in anything more than the
simplest environment.
I think in your case you want to go with what works and what users
will expect. That's the most important. Trying to achieve strict
consistency on query parameters across the entire breadth of
OpenStack isn't being considerate of the differents contexts of use
and users.
[1] https://wiki.openstack.org/wiki/Meetings/API-WG#Agenda
--
Chris Dent ┬─┬ノ( º _ ºノ) https://anticdent.org/
freenode: cdent tw: @anticdent
__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
