You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by "Ryan Ernst (JIRA)" <ji...@apache.org> on 2016/09/20 18:57:20 UTC

[jira] [Created] (LUCENE-7453) Change naming of variables/apis from docid to docnum

Ryan Ernst created LUCENE-7453:
----------------------------------

             Summary: Change naming of variables/apis from docid to docnum
                 Key: LUCENE-7453
                 URL: https://issues.apache.org/jira/browse/LUCENE-7453
             Project: Lucene - Core
          Issue Type: Improvement
            Reporter: Ryan Ernst


In SOLR-9528 a suggestion was made to change {{docid}} to {{docnum}}. The reasoning for this is most notably that {{docid}} has a connotation about a persistent unique identifier (eg like {{_id}} in elasticsearch or {{id}} in solr), while {{docid}} in lucene is currently some local to a segment, and not comparable directly across segments.

When I first started working on Lucene, I had this same confusion. {{docnum}} is a much better name for this transient, segment local identifier for a doc. Regardless of what solr wants to do in their api (eg keeping _docid_), I think we should switch the lucene apis and variable names to use docnum.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org