[GitHub] [solr] HoustonPutman commented on a diff in pull request #1486: SOLR-16708: Update major-changes-in-solr-9.adoc

["HoustonPutman (via GitHub)" <gi...@apache.org>]

HoustonPutman commented on code in PR #1486:
URL: https://github.com/apache/solr/pull/1486#discussion_r1146568163


##########
solr/solr-ref-guide/modules/upgrade-notes/pages/solr-upgrade-notes.adoc:
##########
@@ -35,18 +34,29 @@ that may affect your existing implementation.
 
 Detailed steps for upgrading a Solr cluster are in the section xref:deployment-guide:upgrading-a-solr-cluster.adoc[].
 
-// DO NOT ADD MINOR VERSION INFO HERE; see child pages
+== How to use the Major Changes pages
+
+The Major Changes pages are grouped in two ways:
+- For Solr versions `9.y+`:
+  The `Major Changes in Solr _x_` (e.g. xref:major-changes-in-solr-9.adoc[]) pages include all changes included in any `x.y` release.
+  Therefore xref:major-changes-in-solr-9.adoc[] includes all changes in any Solr `9.x` release.
+- For Solr versions `6.y`-`8.y`:
+  The `Major Changes in Solr _x_` (e.g. xref:major-changes-in-solr-8.adoc[]) pages include all changes from Solr `_(x-1)_.0` to Solr `_x_.0`.
+  Therefore xref:major-changes-in-solr-8.adoc[] includes all changes from Solr `7.0` to Solr `8.0`, starting wil Solr `7.1`.
+
+In these pages, the first section describes planning for an upgrade from to that major version from the previous major version,

Review Comment:
   thanks for catching this!



-- 
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: issues-unsubscribe@solr.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@solr.apache.org
For additional commands, e-mail: issues-help@solr.apache.org