From commits-return-120472-archive-asf-public=cust-asf.ponee.io@lucene.apache.org Fri Jan 15 21:00:49 2021 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mxout1-he-de.apache.org (mxout1-he-de.apache.org [95.216.194.37]) by mx-eu-01.ponee.io (Postfix) with ESMTPS id B37EC180654 for ; Fri, 15 Jan 2021 22:00:49 +0100 (CET) Received: from mail.apache.org (mailroute1-lw-us.apache.org [207.244.88.153]) by mxout1-he-de.apache.org (ASF Mail Server at mxout1-he-de.apache.org) with SMTP id 9EC6F664AB for ; Fri, 15 Jan 2021 21:00:48 +0000 (UTC) Received: (qmail 81486 invoked by uid 500); 15 Jan 2021 21:00:47 -0000 Mailing-List: contact commits-help@lucene.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@lucene.apache.org Delivered-To: mailing list commits@lucene.apache.org Received: (qmail 81379 invoked by uid 99); 15 Jan 2021 21:00:47 -0000 Received: from ec2-52-202-80-70.compute-1.amazonaws.com (HELO gitbox.apache.org) (52.202.80.70) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 15 Jan 2021 21:00:47 +0000 Received: by gitbox.apache.org (ASF Mail Server at gitbox.apache.org, from userid 33) id 109528E7AB; Fri, 15 Jan 2021 21:00:47 +0000 (UTC) Date: Fri, 15 Jan 2021 21:00:46 +0000 To: "commits@lucene.apache.org" Subject: [lucene-solr] 01/02: SOLR-14560: ref guide: remove references to XML output when examples are all JSON MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit From: ctargett@apache.org In-Reply-To: <161074444472.27080.15651069841844017194@gitbox.apache.org> References: <161074444472.27080.15651069841844017194@gitbox.apache.org> X-Git-Host: gitbox.apache.org X-Git-Repo: lucene-solr X-Git-Refname: refs/heads/branch_8x X-Git-Reftype: branch X-Git-Rev: 9bea04b8a4974334e52051f5f58391921c89a56e X-Git-NotificationType: diff X-Git-Multimail-Version: 1.5.dev Auto-Submitted: auto-generated Message-Id: <20210115210047.109528E7AB@gitbox.apache.org> This is an automated email from the ASF dual-hosted git repository. ctargett pushed a commit to branch branch_8x in repository https://gitbox.apache.org/repos/asf/lucene-solr.git commit 9bea04b8a4974334e52051f5f58391921c89a56e Author: Cassandra Targett AuthorDate: Thu Jan 14 15:07:22 2021 -0600 SOLR-14560: ref guide: remove references to XML output when examples are all JSON --- solr/solr-ref-guide/src/learning-to-rank.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/solr/solr-ref-guide/src/learning-to-rank.adoc b/solr/solr-ref-guide/src/learning-to-rank.adoc index 6f54b86..4edd554 100644 --- a/solr/solr-ref-guide/src/learning-to-rank.adoc +++ b/solr/solr-ref-guide/src/learning-to-rank.adoc @@ -158,7 +158,7 @@ To extract features as part of a query, add `[features]` to the `fl` parameter, [source,text] http://localhost:8983/solr/techproducts/query?q=test&fl=id,score,[features] -The output XML will include feature values as a comma-separated list, resembling the output shown here: +The output will include feature values as a comma-separated list, resembling the output shown here: [source,json] ---- @@ -223,14 +223,14 @@ To rerank the results of a query, add the `rq` parameter to your search, for exa [source,text] http://localhost:8983/solr/techproducts/query?q=test&rq={!ltr model=myModel reRankDocs=100}&fl=id,score -The addition of the `rq` parameter will not change the output XML of the search. +The addition of the `rq` parameter will not change the output of the search. To obtain the feature values computed during reranking, add `[features]` to the `fl` parameter, for example: [source,text] http://localhost:8983/solr/techproducts/query?q=test&rq={!ltr model=myModel reRankDocs=100}&fl=id,score,[features] -The output XML will include feature values as a comma-separated list, resembling the output shown here: +The output will include feature values as a comma-separated list, resembling the output shown here: [source,json] ---- @@ -266,7 +266,7 @@ To obtain the model that interleaving picked for a search result, computed durin [source,text] http://localhost:8983/solr/techproducts/query?q=test&rq={!ltr model=myModelA model=myModelB reRankDocs=100}&fl=id,score,[interleaving] -The output XML will include the model picked for each search result, resembling the output shown here: +The output will include the model picked for each search result, resembling the output shown here: [source,json] ---- @@ -291,21 +291,21 @@ The output XML will include the model picked for each search result, resembling ---- === Running a Rerank Query Interleaving a model with the original ranking -When approaching Search Quality Evaluation with interleaving it may be useful to compare a model with the original ranking. +When approaching Search Quality Evaluation with interleaving it may be useful to compare a model with the original ranking. To rerank the results of a query, interleaving a model with the original ranking, add the `rq` parameter to your search, passing the special inbuilt `_OriginalRanking_` model identifier as one model and your comparison model as the other model, for example: [source,text] http://localhost:8983/solr/techproducts/query?q=test&rq={!ltr model=_OriginalRanking_ model=myModel reRankDocs=100}&fl=id,score -The addition of the `rq` parameter will not change the output XML of the search. +The addition of the `rq` parameter will not change the output of the search. To obtain the model that interleaving picked for a search result, computed during reranking, add `[interleaving]` to the `fl` parameter, for example: [source,text] http://localhost:8983/solr/techproducts/query?q=test&rq={!ltr model=_OriginalRanking_ model=myModel reRankDocs=100}&fl=id,score,[interleaving] -The output XML will include the model picked for each search result, resembling the output shown here: +The output will include the model picked for each search result, resembling the output shown here: [source,json] ----