[
https://issues.apache.org/jira/browse/SOLR-14726?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17173968#comment-17173968
]
Ishan Chattopadhyaya commented on SOLR-14726:
---------------------------------------------
bq. If we abstract this a bit, it becomes "let's make it super-simple to index
any data whatsoever".
Absolutely, +1
bq. 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.
For an example showing indexing of some documents residing in a directory, I
agree that is better than a complex curl request. But, in most cases, we want
to show the user how to index regular documents like JSON or CSV etc. We have
no example of a JSON document sent to the /update or /update/json/docs
endpoint, even though this is what the main usecase is for most people. For
those, I strongly favour using curl. It helps develop familiarity in dealing
with indexing documents into Solr even for production environments where a
developer doesn't have bin/solr access.
By the way, expert users and committers are sometimes not aware of something
that we need every regular user to be aware of!
https://twitter.com/dep4b/status/1292191202624897025. No better place than the
solr tutorial, IMHO.
> 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
