diff --git a/docs/news/unreleased/osbuild-schema-2.md b/docs/news/unreleased/osbuild-schema-2.md
index eeae9d4f9..d885a8fb1 100644
--- a/docs/news/unreleased/osbuild-schema-2.md
+++ b/docs/news/unreleased/osbuild-schema-2.md
@@ -1,8 +1,18 @@
-# Support new OSBuild pipelines and RHEL for Edge commit installer image type
+# Support new OSBuild pipelines and new RHEL for Edge image types
 
 OSBuild Composer can now generate Manifests that conform to the new OSBuild
-schema.  A new image type is added that takes advantage of the new schema
-called `rhel-edge-container`.  This image type creates an OCI container with an
-HTTP server that serves the same payload as a `rhel-edge-commit`.
+schema.  Two new image types are added that take advantage of the new schema:
+
+- `rhel-edge-container`: Creates an OCI container with an embedded
+  `rhel-edge-commit`.  Running the container starts a web server that serves
+  the commit.
+
+- `rhel-edge-installer`: Creates a boot ISO image that embeds a
+  `rhel-edge-commit`.  The commit is pulled from a URL during the compose of
+  the boot ISO.
+
+Requesting a `rhel-edge-installer` requires specifying a URL, otherwise the
+request will fail.  Blueprint customizations have no effect on the boot ISO and
+also cause the request to fail if any are specified.
 
 Relevant PR: https://github.com/osbuild/osbuild-composer/pull/1244