SOLR-18464: Fix three Antora build warnings in the ref guide

[serhiy-bzhezytskyy]

https://issues.apache.org/jira/browse/SOLR-18464

Description

Building the ref guide site (./gradlew :solr:solr-ref-guide:buildLocalAntoraSite) produces one error and several warnings:

• deployment-guide/pages/rule-based-authorization-plugin.adoc:425: a cols="1,1,1" table listing collection-admin-edit's allowed actions had 18 entries when written, but SOLR-18370 (SOLR-18370: remove the ADDROLE/REMOVEROLE Overseer Roles API #4772) removed ADDROLE/REMOVEROLE, leaving 16 — not divisible by 3, so Asciidoctor drops cells from the resulting incomplete last row. The rendered page has likely been missing REBALANCELEADERS since that PR merged.

• configuration-guide/pages/configsets-api.adoc (2 places) and indexing-guide/pages/document-enrichment-with-llms.adoc (4 places): prose and example XML use literal {configSetName}, {filePath}, and {string_field} as path/placeholder templates. Asciidoctor treats any {...} as a document-attribute reference by default, so it tries (and fails) to substitute an undefined attribute.

Solution

• Changed the table to cols="1,1,1,1" (16 items / 4 columns = 4 even rows) instead of padding with empty cells.

• Escaped the opening brace (\{configSetName}, \{filePath}, \{string_field}) so they render literally, matching the existing convention used elsewhere in the guide (e.g. deployment-guide/pages/node-roles.adoc, deployment-guide/pages/task-management.adoc).

Tests

Ran ./gradlew :solr:solr-ref-guide:buildLocalAntoraSite and :checkSiteLinks before and after: 1 error + 5 warnings → 0. No other pages affected.

AI-assisted (Claude Sonnet 5).

[serhiy-bzhezytskyy]

@epugh tagging you since this is under SOLR-18459/SOLR-18464, which you filed.

[malliaridis]

LGTM. Addresses the warnings shown when running the buildLocalSite task. Thanks for addressing these.