You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by Chris Hostetter <ho...@fucit.org> on 2015/04/16 17:48:04 UTC
Re: [CONF] Apache Solr Reference Guide > Uploading Data with Index
Handlers
Noble - did you consider how this change affects the JSON section as a
whole?
You've now using the convinience path /update/json/docs in an example, 2
sub-sections before those convinience paths are introduced.
the strucutre was setup so that the basics of sending JSON were explained
first *then* the convininece paths and simple forms were introduced.
if folks think we should flip that (show the simple examples, then
elaborate) that's fine -- but your quick hack to the page just makes it
more confusing - first we tell the user that to add a single doc they
need json.command=false, then in the very first example where we add a
single doc, we *don't* use that paraam, and then we wait until a few
sections later we explain why it works.
the concepts either needs to be presented 1-2-3-4, or 4-3-2-1 ... you've
got it all jumbled up now.
: Date: Thu, 16 Apr 2015 08:42:00 +0000 (UTC)
: From: "Noble Paul (Confluence)" <co...@apache.org>
: Reply-To: dev@lucene.apache.org
: To: commits@lucene.apache.org
: Subject: [CONF] Apache Solr Reference Guide > Uploading Data with Index
: Handlers
:
: [IMAGE]
: Noble Paul edited the page:
:
: [IMAGE] UPLOADING DATA WITH INDEX HANDLERS
:
: Comment: Eliminate the json.command option , which confuses the users
:
: View Online · Like · View Changes · Add Comment
: Stop watching space · Manage Notifications
: This message was sent by Atlassian Confluence 5.0.3, Team Collaboration Software
:
-Hoss
http://www.lucidworks.com/
Re: [CONF] Apache Solr Reference Guide > Uploading Data with Index Handlers
Posted by Noble Paul <no...@gmail.com>.
+1 for making the command smaller
On Sat, Apr 18, 2015 at 11:30 PM, Yonik Seeley <ys...@gmail.com> wrote:
> On Sat, Apr 18, 2015 at 12:50 AM, Noble Paul <no...@gmail.com> wrote:
> > I find it confusing why a user should be aware of the option
> json.comand=false.
>
> Me too - confusing and somewhat ugly. Just using a different URL seems
> nicer.
>
> And of course I'm not a fan of our huge redundant curl lines that look
> bigger than the data we are sending.
>
> This
> curl -X POST -H 'Content-Type: application/json'
> 'http://localhost:8983/solr/demo/update/json/docs' --data-binary
> could be replaced with something half the size:
> curl http://localhost:8983/solr/demo/update/json/docs -d
>
> -Yonik
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: dev-help@lucene.apache.org
>
>
--
-----------------------------------------------------
Noble Paul
Re: [CONF] Apache Solr Reference Guide > Uploading Data with Index Handlers
Posted by Yonik Seeley <ys...@gmail.com>.
On Sat, Apr 18, 2015 at 12:50 AM, Noble Paul <no...@gmail.com> wrote:
> I find it confusing why a user should be aware of the option json.comand=false.
Me too - confusing and somewhat ugly. Just using a different URL seems nicer.
And of course I'm not a fan of our huge redundant curl lines that look
bigger than the data we are sending.
This
curl -X POST -H 'Content-Type: application/json'
'http://localhost:8983/solr/demo/update/json/docs' --data-binary
could be replaced with something half the size:
curl http://localhost:8983/solr/demo/update/json/docs -d
-Yonik
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org
Re: [CONF] Apache Solr Reference Guide > Uploading Data with Index Handlers
Posted by Noble Paul <no...@gmail.com>.
We may consider it as a convenience path. A normal user does not really
look at it like that
We need to clearly state that
1) for json with the commands use /update/json
2) For simple JSON use /update/json/docs
I find it confusing why a user should be aware of the option
json.comand=false. It is just counter intuitive to do same thing in two
different ways
On Thu, Apr 16, 2015 at 9:18 PM, Chris Hostetter <ho...@fucit.org>
wrote:
>
> Noble - did you consider how this change affects the JSON section as a
> whole?
>
> You've now using the convinience path /update/json/docs in an example, 2
> sub-sections before those convinience paths are introduced.
>
> the strucutre was setup so that the basics of sending JSON were explained
> first *then* the convininece paths and simple forms were introduced.
>
> if folks think we should flip that (show the simple examples, then
> elaborate) that's fine -- but your quick hack to the page just makes it
> more confusing - first we tell the user that to add a single doc they
> need json.command=false, then in the very first example where we add a
> single doc, we *don't* use that paraam, and then we wait until a few
> sections later we explain why it works.
>
> the concepts either needs to be presented 1-2-3-4, or 4-3-2-1 ... you've
> got it all jumbled up now.
>
>
> : Date: Thu, 16 Apr 2015 08:42:00 +0000 (UTC)
> : From: "Noble Paul (Confluence)" <co...@apache.org>
> : Reply-To: dev@lucene.apache.org
> : To: commits@lucene.apache.org
> : Subject: [CONF] Apache Solr Reference Guide > Uploading Data with Index
> : Handlers
> :
> : [IMAGE]
> : Noble Paul edited the page:
> :
> : [IMAGE] UPLOADING DATA WITH INDEX HANDLERS
> :
> : Comment: Eliminate the json.command option , which confuses the users
> :
> : View Online · Like · View Changes · Add Comment
> : Stop watching space · Manage Notifications
> : This message was sent by Atlassian Confluence 5.0.3, Team Collaboration
> Software
> :
>
> -Hoss
> http://www.lucidworks.com/
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: dev-help@lucene.apache.org
>
--
-----------------------------------------------------
Noble Paul