[
https://issues.apache.org/jira/browse/SOLR-7312?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14382374#comment-14382374
]
Mark Haase edited comment on SOLR-7312 at 3/26/15 6:17 PM:
-----------------------------------------------------------
You must not have read my entire message, so let me put this in bold:
{quote}
*I'm not saying "Solr should do this." I realize that Solr/Lucene is a huge
project with finite resources and this probably isn't a high priority*
{quote}
But the docs are buggy. They use a term that is incorrect. This is akin to
misspelling a word over and over in the documentation and then claiming, "oh we
don't like to use that word anyway." _Then remove it!_
That's not bending over backwards; that's called decent documentation.
was (Author: mehaase):
You must not have read my entire message, so let me put this in bold:
{quote}
*I'm not saying "Solr should do this." I realize that Solr/Lucene is a huge
project with finite resources and this probably isn't a high priority*
{quote}
But the docs are buggy. They use a term that is incorrect. This is akin to
misspelling a word over and over in the documentation and then claiming, "oh we
don't like to use that word anyway." _Then remove it!_ That's not bending over
backwards; that's called decent documentation.
> "REST" API is not REST
> ----------------------
>
> Key: SOLR-7312
> URL: https://issues.apache.org/jira/browse/SOLR-7312
> Project: Solr
> Issue Type: Improvement
> Components: Server
> Affects Versions: 5.0
> Reporter: Mark Haase
> Assignee: Noble Paul
>
> The documentation refers to a "REST" API over and over, and yet I don't see a
> REST API. I see an HTTP API but not a REST API. Here are a few things the
> HTTP API does that are not RESTful:
> * Offers RPC verbs instead of resources/nouns. (E.g. schema API has commands
> like "add-field", "add-copy-field", etc.)
> * Tunnels non-idempotent requests (like creating a core) through idempotent
> HTTP verb (GET).
> * Tunnels deletes through HTTP GET.
> * PUT/POST confusion, POST used to update a named resource, such as the Blob
> API.
> * Returns `200 OK` HTTP code even when the command fails. (Try adding a field
> to your schema that already exists. You get `200 OK` and an error message
> hidden in the payload. Try calling a collections API when you're using
> non-cloud mode: `200 OK` and an error message in the payload. Gah.)
> * Does not provide link relations.
> * HTTP status line contains a JSON payload (!) and no 'Content-Type' header
> for some failed commands, like `curl -X DELETE
> http://solr:8983/solr/admin/cores/foo`
> * Content negotiation is done via query parameter (`wt=json`), instead of
> `Accept` header.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
