[
https://issues.apache.org/jira/browse/SOLR-14726?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17173964#comment-17173964
]
Erick Erickson commented on SOLR-14726:
---------------------------------------
Hmmm. In the past, we provided sample data and configsets to give people a
place to start. Let's back up a bit. That approach was based on the model of
Solr where there was a learning curve (to put it politely) to get over first
before being able to do anything. We provided canned examples that we knew
would work.
If we abstract this a bit, it becomes "let's make it super-simple to index any
data whatsoever".
I'm not wild about replacing bin/solr with curl. WDYT about "bin/solr
index_this_thing something"? Where "something" is a directory, a file,
whatever. That would give us more control over what/how we send things to Solr.
I suppose it comes down to a question of where we want to put the smarts. We
either put it in Solr or put it in bin/solr (or something). A curl command that
took a directory seems "fraught".
I'm not even sure bin/solr is the right place, but you see where this is
heading. We could even use the Tika server idea to process docs on the client
side and avoid ExtractingRequestHandler all together.
Anyway, random thoughts for discussion....
> Streamline getting started experience
> -------------------------------------
>
> Key: SOLR-14726
> URL: https://issues.apache.org/jira/browse/SOLR-14726
> Project: Solr
> Issue Type: Task
> Security Level: Public(Default Security Level. Issues are Public)
> Reporter: Ishan Chattopadhyaya
> Priority: Major
> Labels: newdev
>
> The reference guide Solr tutorial is here:
> https://lucene.apache.org/solr/guide/8_6/solr-tutorial.html
> It needs to be simplified and easy to follow. Also, it should reflect our
> best practices, that should also be followed in production. I have following
> suggestions:
> # Make it less verbose. It is too long. On my laptop, it required 35 page
> downs button presses to get to the bottom of the page!
> # First step of the tutorial should be to enable security (basic auth should
> suffice).
> # {{./bin/solr start -e cloud}} <-- All references of -e should be removed.
> # All references of {{bin/solr post}} to be replaced with {{curl}}
> # Convert all {{bin/solr create}} references to curl of collection creation
> commands
> # Add docker based startup instructions.
> # Create a Jupyter Notebook version of the entire tutorial, make it so that
> it can be easily executed from Google Colaboratory. Here's an example:
> https://twitter.com/TheSearchStack/status/1289703715981496320
> # Provide downloadable Postman and Insomnia files so that the same tutorial
> can be executed from those tools. Except for starting Solr, all other steps
> should be possible to be carried out from those tools.
> # Use V2 APIs everywhere in the tutorial
> # Remove all example modes, sample data (films, tech products etc.),
> configsets from Solr's distribution (instead let the examples refer to them
> from github)
> # Remove the post tool from Solr, curl should suffice.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org
For additional commands, e-mail: issues-h...@lucene.apache.org
