[jira] [Updated] (SOLR-14032) improve ref-guide docs on boosting by function/query

["Chris M. Hostetter (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/SOLR-14032?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Chris M. Hostetter updated SOLR-14032:
--------------------------------------
    Attachment: SOLR-14032.patch
        Status: Open  (was: Open)

Attached Patch...
 * other-parsers.adoc
 ** beefs up the section on BoostQParser
 ** clarifies that 'b' must be a function
 ** clarifies that this is a multiplicative boost, and the final scores are a product of the original query and the function
 ** adds more examples, including:
 *** how to use the {{div(...)}} function to "demote" documents using an inverse function
 *** how to use the {{query(...)}} function to boost by the scores of a secondary query
 * the-extended-dismax-query-parser.adoc
 ** remove the totally nonsensical section on "negative boosts"
 *** i'm not sure where/why this was in here as a top level section but it doesn't look like it ever made sense
 *** what little sense it may have made in the past hasn't been true since 8.0 (see LUCENE-7996)
 ** beef up the docs on {{boost}} param...
 *** actually link to the existing docs on {{BoostQParser}} instead of just refering to it
 *** show examples of how using it is shorthand syntax
 *** (breifly) mention how this is better then using {{bq}} and {{bf}} inherited from dismax
 * the-dismax-query-parser.adoc
 ** provide more details on how exactly the {{bq}} param works
 *** clarify that {{bq}} is an additive boost, not a multiplicitive one
 *** provide some context on the shortcomings of additive boosts and why users would probably prefer to use the {{boost}} parser to get a multiplicitive boost.
 ** update the {{bf}} docs to demonstrate it's just a shorthand for the {{bq}} param...
 *** with the same additive boosting shortcomings

...unless anyone has concerns, i'll commit these edits soon.

> improve ref-guide docs on boosting by function/query
> ----------------------------------------------------
>
>                 Key: SOLR-14032
>                 URL: https://issues.apache.org/jira/browse/SOLR-14032
>             Project: Solr
>          Issue Type: Improvement
>      Security Level: Public(Default Security Level. Issues are Public) 
>          Components: documentation, query parsers
>            Reporter: Chris M. Hostetter
>            Assignee: Chris M. Hostetter
>            Priority: Major
>         Attachments: SOLR-14032.patch
>
>
> A recent conversation with someone about "boosting" by queries/functions made me realize there is a lot of missing/bad info in the ref-guide. I've got some suggested improvements to attach....



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

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