[ 
https://issues.apache.org/jira/browse/SOLR-14726?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17429957#comment-17429957
 ] 

Ishan Chattopadhyaya commented on SOLR-14726:
---------------------------------------------

bq. 1. The only officially supported driver is Java. Java has plummeted as a 
first choice language for companies building new apps. This is a fact of 
companies large and small. I am not suggesting Java should go away. I am not 
that naive. I am suggesting that by electing to only support it as a client 
library, you are signaling to a large swathe of users – go use Elasticsearch! 

I very much agree with this sentiment. We need to pay more attention to Go, 
Python etc. client libraries. If there are existing libraries, we should bring 
them up to speed with new features and document their use in the ref guide.


bq. 2. I stand by the claim that two modes of operation are confusing. In SOLR 
>8.2, there is no longer a great reason to keep this user experience obstacle 
allowed. People should not even know Zookeeper exists. It’s a workhorse, let it 
work. 

I'd much rather the standalone mode be gone, and we have ZK embedded into each 
node. But, I know the community is split on this. Way to solve this confusion 
is to provide a concise documentation about these two modes in the getting 
started page itself.

bq. 3. Ishan’s point about the video is crucial. All developers are different, 
and they require different mediums. 
This is a great idea, and it was your initial idea, Marcus.

bq. 4. Making it easier to get started will not hurt training businesses. It 
will grow them. The more people that can get started, the more people will use 
the project overall. 
Absolutely! Spot on.. Everything Solr based business will grow if we can arrest 
Solr's shrinkage from users' mindshare.

bq. I hope that everyone not sucked into Lucene internals (as I have been for a 
couple months because of fundamental problem) works on this ticket.
I'll try to do something about this over the weekends (or late nights on 
weekdays). I've assigned the ticket to myself for now.

> Streamline getting started experience
> -------------------------------------
>
>                 Key: SOLR-14726
>                 URL: https://issues.apache.org/jira/browse/SOLR-14726
>             Project: Solr
>          Issue Type: Task
>            Reporter: Ishan Chattopadhyaya
>            Assignee: Ishan Chattopadhyaya
>            Priority: Major
>              Labels: newdev
>         Attachments: yasa-http.png
>
>
> 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...@solr.apache.org
For additional commands, e-mail: issues-h...@solr.apache.org

Reply via email to