rahulgoswami commented on code in PR #4127:
URL: https://github.com/apache/solr/pull/4127#discussion_r2808566035


##########
solr/solr-ref-guide/modules/deployment-guide/pages/solr-control-script-reference.adoc:
##########
@@ -277,6 +242,56 @@ To emphasize how the default settings work take a moment 
to understand that the
 
 `bin/solr start --host localhost -p 8983 --server-dir server --solr-home solr 
-m 512m`
 
+`-e <name>` or `--example <name>`::
++
+[%autowidth,frame=none]
+|===
+|Optional |Default: none
+|===
++
+Start Solr with an example configuration.
+These examples are provided to help you get started faster with Solr 
generally, or just try a specific feature.
++
+The available options are:
+
+* `cloud`: SolrCloud example
+* `techproducts`: Comprehensive example illustrating many of Solr's core 
capabilities
+* `schemaless`: Schema-less example (schema is inferred from data during 
indexing)
+* `films`: Example of starting with _default configset and adding explicit 
fields dynamically
++
+See the section <<Running with Example Configurations>> below for more details 
on the example configurations.
++
+*Example*: `bin/solr start -e schemaless`
+
+`--no-prompt`::
++
+[%autowidth,frame=none]
+|===
+|Optional |Default: none
+|===
++
+Don't prompt for input; accept all defaults when running examples that accept 
user input.
++
+For example, when using the "cloud" example, an interactive session guides you 
through several options for your SolrCloud cluster.
+If you want to accept all of the defaults, you can simply add the 
`--no-prompt` option to your request.
++
+*Example*: `bin/solr start -e cloud --no-prompt`
+
+`--prompts <values>`::
++
+[%autowidth,frame=none]
+|===
+|Optional |Default: none
+|===
++
+Don't prompt for input; provide defaults in comma delimited format when 
running examples that accept user input.
++
+For example, when using the "cloud" example, can start a three node cluster on 
specific ports:
++
+*Example*: `bin/solr start -e cloud --prompts 
3,9000,9001,9002,"mycollection",2,2,_defaults`

Review Comment:
   The way I think about this...someone who is trying solr for the first time 
won't know that a `--no-prompt` or `--prompt-inputs` option exists unless they 
go looking, and when they do, both terms might sound equally _misleading_ at 
first in today's AI world. But then we already have a `--no-prompt` option and 
we are not going back. TLDR; doesn't matter for new users. They should come 
around once they read the option description and then _hopefully_ both options 
make sense in conjunction.
   
   For those familiar with running solr and playing with examples, they are 
likely aware of the `--no-prompt` option already. And for them, 
`--prompt-inputs` should be a relatable extension. 



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to