serhiy-bzhezytskyy opened a new pull request, #4922: URL: https://github.com/apache/solr/pull/4922
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 (#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). -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
