[ 
https://issues.apache.org/jira/browse/LUCENE-1908?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12754731#action_12754731
 ] 

Ted Dunning commented on LUCENE-1908:
-------------------------------------


I apologize for complaining here without actually editing this text to 
illustrate what I would rather see, but the new text seems to say things like 
"the scoring function is like this (formula) except that it isn't because it is 
really like this (other-formula) but that isn't really right either because it 
is like this (still-another-formula) which actually isn't right because of 
fields and <mumble>".

There are also many small errors such as claiming that tf is *proportional* to 
term frequency and idf is *proportional* to inverse of document frequency.  
Proportional means that there is a linear relationship which is definitely not 
the case here.  It would be better to say tf usually increases with increasing 
term frequency, although occasionally a constant might be used.  IDF, on the 
other hand, decreases with increasing document frequency. 


> Similarity javadocs for scoring function to relate more tightly to scoring 
> models in effect
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-1908
>                 URL: https://issues.apache.org/jira/browse/LUCENE-1908
>             Project: Lucene - Java
>          Issue Type: Improvement
>          Components: Search
>            Reporter: Doron Cohen
>            Assignee: Doron Cohen
>            Priority: Minor
>             Fix For: 2.9
>
>         Attachments: LUCENE-1908.patch, LUCENE-1908.patch, LUCENE-1908.patch
>
>
> See discussion in the related issue.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


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

Reply via email to