HoustonPutman commented on PR #1021:
URL: https://github.com/apache/solr/pull/1021#issuecomment-1254119922

   Right now our docs are structured such that we are expecting users to 
upgrade from an outdated minor version to the `x.0` release of the next 
version. To me it would be clearer to have it like David is doing, but then we 
kind of need to either change the page names (which is fine because we are on 
antora now) so that `major-changes-in-solr-9.adoc` forwards requests too 
`solr-8-upgrade-notes.adoc` and have all 8.0-8.11 notes there. So that the 
anchor to 9.0 in that current page is not broken, we can have a small section 
at the end that links to `solr-9-upgrade-notes.adoc#9.0` or something like that.
   
   At this point we won't need to do anything for a major release, and links 
stay consistent even when the major version is cut.
   We can also trust people to look at all of the versions that they are 
skipping, even if it's on a different page.
   
   I can try to hack something together tomorrow if y'all want to see it to 
completion after that.


-- 
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