[
https://issues.apache.org/jira/browse/SOLR-18463?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18117952#comment-18117952
]
Eric Pugh commented on SOLR-18463:
----------------------------------
After revieiwng the PR, what I came to the realization is that looking at this
more, and looking at the PostTool.java, and the fact that the name of the file
is "PostTool" and then, looking at how we refer to things in
[#3254|https://github.com/apache/solr/pull/3254], for example "This tool does
not yet support PicoCli", that then makes me feel like we need to either pick
"Tool" or "Command" and then lean into the specific name, across BOTH the java
code and the ref guide docs. That I think helps us the most, because we know
how to grep for the code in both ref guide and source, etc.
For what it's worth, Picocli uses {{picocli.CommandLine.Command}} to annotate
"this is a command"..... But again, we can use Tool...
[@janhoy|https://github.com/janhoy] WDYT? Anyone else have an opinion?
> Reference our cli tools as "Solr CLI".... looking at you Post Tool
> -------------------------------------------------------------------
>
> Key: SOLR-18463
> URL: https://issues.apache.org/jira/browse/SOLR-18463
> Project: Solr
> Issue Type: Sub-task
> Components: documentation
> Reporter: Eric Pugh
> Priority: Major
> Labels: pull-request-available
> Time Spent: 1h 20m
> Remaining Estimate: 0h
>
> Post Tool (and osme others) used to be standalone tools, so they were
> referred that way. These day, they are just all part of Solr CLI, (i.e
> bin/solr) so give them a more accurate name.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
