serhiy-bzhezytskyy opened a new pull request, #4926:
URL: https://github.com/apache/solr/pull/4926

   https://issues.apache.org/jira/browse/SOLR-18462
   
   # Description
   
   "Our docs should be featuring JSON then XML, not XML then JSON." Checked 
every page with both a JSON and an XML section or tab: the 5 existing 
`JSON::`/`XML::` tab examples (in `indexing-nested-documents.adoc` and 
`dense-vector-search.adoc`) already put JSON first. One page didn't: 
`indexing-with-update-handlers.adoc` covers "XML Formatted Index Updates" as a 
whole top-level section before "JSON Formatted Index Updates", with "CSV 
Formatted Index Updates" last.
   
   # Solution
   
   Moved the JSON section ahead of the XML section (CSV stays last). No content 
was changed, only relocated — the diff is exactly 150 insertions and 150 
deletions. Checked first that neither section contains order-dependent prose 
("as we saw above", "the following section", etc.) that would break across the 
move; found none. `xref` anchors are heading-derived, not position-derived, so 
no cross-reference elsewhere in the guide is affected.
   
   # Tests
   
   Ran `./gradlew :solr:solr-ref-guide:buildLocalAntoraSite` and 
`:checkSiteLinks` before and after: same 6 pre-existing warnings (unrelated, 
tracked in #4922/SOLR-18464), no new ones, no broken links.
   
   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]

Reply via email to