[
https://issues.apache.org/jira/browse/SOLR-15885?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17467314#comment-17467314
]
Andy Lester commented on SOLR-15885:
------------------------------------
Over in Slack, [~elyograg] notes that soft commits do not mark an index as
current. This is a perfect example of something that is critical for a reader
to know, but is not in these docs.
> Document the fields returned by STATUS in the CoreAdmin API
> -----------------------------------------------------------
>
> Key: SOLR-15885
> URL: https://issues.apache.org/jira/browse/SOLR-15885
> Project: Solr
> Issue Type: Improvement
> Security Level: Public(Default Security Level. Issues are Public)
> Components: documentation
> Reporter: Andy Lester
> Priority: Minor
>
> The docs for CoreAdmin API
> (https://solr.apache.org/guide/8_11/coreadmin-api.html) don't explain what
> the fields coming back from the STATUS call are. Some seem self-explanatory,
> but some aren't.
>
> {{{}}
> {{ "name": "scratch",}}
> {{ "dataDir": "/var/solr/data/scratch/data/",}}
> {{ "numdocs": 42582139,}}
> {{ "size": "28.06 GB",}}
> {{ "sizeInBytes": 30126369712,}}
> {{ "lastModified": "2021-12-08T22:07:05.133Z",}}
> {{ "current": true,}}
> {{ "version": 43463}}
> {{}}}
>
> Specifically, the meaning of "current" and "version" are not explained. If
> these refer back to Lucene-based concepts, we should explain them briefly
> here and point to the relevant Lucene docs, or to the appropriate Solr docs.
> ([https://lucene.apache.org/core/8_8_1/core/org/apache/lucene/index/DirectoryReader.html)]
> What exactly does "current" mean from the Solr user's perspective. Does it
> mean that there are no updates waiting to be committed, and that all I have
> to do is force a commit? Is there more to it?
> Is there anything useful that can be done with that version number? What
> exactly increments it? A link to relevant docs should be enough if it's
> covered elsewhere.
>
--
This message was sent by Atlassian Jira
(v8.20.1#820001)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
