[ http://issues.apache.org/jira/browse/LUCENE-664?page=comments#action_12431631 ] Doug Cutting commented on LUCENE-664: -------------------------------------
This is good stuff. Might it be better to include this in the javadoc? That way, as the code evolves, the documentation is more naturally maintained, since search-and-replace operations etc. will find it. I worry that as soon as this documentation is complete, we'll change the implementation and invalidate it. > [PATCH] small fixes to the new scoring.html doc > ----------------------------------------------- > > Key: LUCENE-664 > URL: http://issues.apache.org/jira/browse/LUCENE-664 > Project: Lucene - Java > Issue Type: Improvement > Components: Website > Affects Versions: 2.0.1 > Reporter: Michael McCandless > Attachments: lucene.uxf, scoring-small-fixes.patch, > scoring-small-fixes2.patch, scoring-small-fixes3.patch > > > This is an awesome initiative. We need more docs that cleanly explain the > inner workings of Lucene in general... thanks Grant & Steve & others! > I have a few small initial proposed fixes, largely just adding some more > description around the components of the formula. But also a couple typos, > another link out to Wikipedia, a missing closing ), etc. I've only made it > through the "Understanding the Scoring Formula" section so far. -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa - For more information on JIRA, see: http://www.atlassian.com/software/jira --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]