Add documentation about script rescorer

[mayya-sharipova]

PR #74274 introduced a new rescorer based on script.
This adds a documentation for this rescorer.

[elasticsearchmachine]

Pinging @elastic/es-docs (Team:Docs)

[elasticsearchmachine]

Pinging @elastic/es-search-relevance (Team:Search Relevance)

[leemthompo]

Hi @mayya-sharipova, because you moved stuff into a new page you'll need to add a redirect in https://github.com/elastic/elasticsearch/blob/main/docs/redirects.yml to keep existing links working

Also, please use applies_to's to make it clear which versions the new functionality is relevant to.

[john-wagster]

lgtm

[elasticsearchmachine]

Pinging @elastic/core-docs (Team:Docs)

[mayya-sharipova]

@leemthompo Thanks for the feedback. I've addressed it in 6f1535a. I am unsure about redirect syntax, would appreciate your feedback on this change.

[mayya-sharipova]

@leemthompo Does applies_to need to use both stack and serverless? Or providingstack is sufficient?

[leemthompo]

@mayya-sharipova the page level should mention both 👍

q: should the stack be stack: GA 9.2.0 or does it not make sense to mention a specific version?

[mayya-sharipova]

The whole page is applied to all versions. Only the section Script rescorer is applicable to 9.2.0 which I adjusted accordingly.

[leemthompo]

perfect thx

[benwtrent]

We should also update our spec for the auto-generated API docs: https://github.com/elastic/elasticsearch-specification

[mayya-sharipova]

@leemthompo I've tried several times to do redirect, but none passes CI.
Would appreciate your help on this. Feel free to push to this branch.

[leemthompo]

@mayya-sharipova yikes this is a bit gnarly alright— no worries I'll take a look tomorrow

[github-actions]

🔍 Preview links for changed docs

• docs/reference/elasticsearch/rest-apis/rescore-search-results.md
• docs/reference/aggregations/search-aggregations-metrics-top-hits-aggregation.md
• docs/reference/elasticsearch/rest-apis/collapse-search-results.md
• docs/reference/elasticsearch/rest-apis/filter-search-results.md
• docs/reference/elasticsearch/rest-apis/reciprocal-rank-fusion.md
• docs/reference/elasticsearch/rest-apis/retrievers.md
• docs/reference/elasticsearch/rest-apis/retrievers/rescorer-retriever.md
• docs/reference/query-languages/query-dsl/query-dsl-sparse-vector-query.md
• docs/reference/query-languages/query-dsl/query-dsl-text-expansion-query.md
• docs/reference/query-languages/query-dsl/query-dsl-weighted-tokens-query.md

[leemthompo]

@mayya-sharipova I got the redirect errors to go away in 376f8d2, but there were still some internal links breaking within this doc set so b33aeff just find/replaced the stragglers

[mayya-sharipova]

@leemthompo Thanks so much for your help, really appreciate it.

[leemthompo]

No prob, thanks for your patience @mayya-sharipova luckily you probably won't have to use that redirect mechanism very often 😄