review

Co-authored-by: Jared Watts <[email protected]>
Signed-off-by: Philippe Scorsolini <[email protected]>

Author: phisco

content/v2.0-preview/whats-new/_index.md

@@ -232,25 +232,23 @@ Crossplane deprecated the `ControllerConfig` type in v1.11. It's replaced by the
 Crossplane added external secret stores in v1.7. External secret stores have
 remained in alpha for over two years and are now unmaintained.
 
-Crossplane, introduced configurable default registries (`--registry`) in v1.15,
-when the default moved from `index.docker.io` to `xpkg.upbound.io`. In v1.20
-the default changed to `xpkg.crossplane.io`. Crossplane v2 drops the
-`--registry` flag and requires users to specify a registry URL when installing
-packages, both directly via `spec.package` and indirectly as dependencies.
+Crossplane v2 drops the `--registry` flag that allowed users to specify a default
+registry value and now requires users to always specify a fully qualified URL when
+installing packages, both directly via `spec.package` and indirectly as dependencies.
 Using fully qualified images was already a best practice, but it's now enforced
-to avoid confusion, and ensure users are aware of the registry used by their
-packages.
+to avoid confusion and unexpected behavior, as well as to ensure users are aware
+of the registry used by their packages.
 
 {{<hint "important">}}
 As long as you're not using these deprecated or alpha features, Crossplane v2 is
 backward compatible with Crossplane v1.x.
 {{</hint>}}
 
 {{<hint "important">}}
-Before upgrading to Crossplane v2, please ensure all your Packages fully
-qualified images used by running `kubectl get pkg`, looking for non fully
-qualified images, and update, or rebuild, Packages to use fully qualified
-images, as needed.
+Before upgrading to Crossplane v2, please ensure all your Packages are using fully
+qualified images that explicitly specify a registry, i.e. `registry.example.com/repo/package:tag`.
+
+Run `kubectl get pkg` to look for any packages that are not fully qualified, then update or rebuild any Packages to use fully qualified images as needed.
 {{</hint>}}
 
 <!-- vale gitlab.FutureTense = NO -->