Merge pull request #67788 from adellape/note-skiprange

Author: adellape

modules/olm-fb-catalogs-schemas.adoc

@@ -117,9 +117,12 @@ It is valid for an entry's replaces value to reference another bundle name that
 ----
 ====
 
-////
-For more information about defining upgrade edges, see the upgrade graph reference documentation.
-////
+[WARNING]
+====
+When using the `skipRange` field, the skipped Operator versions are pruned from the update graph and are therefore no longer installable by users with the `spec.startingCSV` property of `Subscription` objects.
+
+If you want to have direct (one version increment) updates to an Operator version from multiple previous versions, and also keep those previous versions available to users for installation, always use the `skipRange` field along with the `replaces` field. Ensure that the `replaces` field points to the immediate previous version of the Operator version in question.
+====
 
 [id="olm-fb-catalogs-olm-bundle_{context}"]
 == olm.bundle schema