In general, I dislike the V2, V3, V<something> when rebranding a method or
a service as it doesn't add any semantic value to the name, on the other
hand, Json-API hints it has to do with JSON payloads.

Given that, I am +1 in rebranding them, but I have no idea at the moment
for a better name than what it's currently in place ...
--------------------------
*Alessandro Benedetti*
Director @ Sease Ltd.
*Apache Lucene/Solr Committer*
*Apache Solr PMC Member*

e-mail: a.benede...@sease.io


*Sease* - Information Retrieval Applied
Consulting | Training | Open Source

Website: Sease.io <http://sease.io/>
LinkedIn <https://linkedin.com/company/sease-ltd> | Twitter
<https://twitter.com/seaseltd> | Youtube
<https://www.youtube.com/channel/UCDx86ZKLYNpI3gzMercM7BQ> | Github
<https://github.com/seaseltd>


On Fri, 17 Feb 2023 at 04:29, David Smiley <dsmi...@apache.org> wrote:

> V2 shouldn't be overloaded then *that* is a problem.  Can we just call the
> new JAX-RS stuff V3 and then voila, we call this V3 faceting API?
>
> ~ David Smiley
> Apache Lucene/Solr Search Developer
> http://www.linkedin.com/in/davidwsmiley
>
>
> On Thu, Feb 16, 2023 at 11:42 AM Houston Putman <hous...@apache.org>
> wrote:
>
> > Thanks for bringing this up!
> >
> > I agree the name of the API is bad. The thing is it's not only faceting,
> > it's also stats/analytics.
> >
> > Maybe the "aggregation API"? but I'm not sure that's any better...
> >
> > I do think "v2" is an already overloaded term that comes with a lot of
> > baggage, so I would personally vote we steer in a different direction.
> >
> > - Houston
> >
> > On Thu, Feb 16, 2023 at 9:42 AM Jan Høydahl <jan....@cominvent.com>
> wrote:
> >
> > > Hi devs,
> > >
> > > Although it's been nagging me for a while, today it hit me that the
> "JSON
> > > request API" has a terrible name.
> > >
> > > I hope to start a discussion on re-branding it and somehow pitch it as
> > the
> > > (not-so-new) "V2" search / facet API. Good timing as part of the other
> V2
> > > efforts.
> > > That may in turn lead to increased usage and take the role as the
> > > "standard" search API instead of the "alternative".
> > >
> > > Of course I know that what we normally mean as "V2" API is the /api/
> URL,
> > > not the syntax of the payload, i.e. you can do both old-style and
> > > JSON-style  queries on both V1 adn V2 search endpoint. So I'm not sold
> on
> > > "V2" being the perfect name here. But from a pure branding perspective,
> > > signaling that it is the "new" way, perhaps it can fly?
> > >
> > > See JIRA https://issues.apache.org/jira/browse/SOLR-16663 for some
> > > initial thougts. Please keep the broader discussion here, and more
> > > implementation related input in JIRA.
> > >
> > > Jan
> >
>

Reply via email to