diff --git a/CHANGELOG_PENDING.md b/CHANGELOG_PENDING.md
index b8841111..33a35ca1 100644
--- a/CHANGELOG_PENDING.md
+++ b/CHANGELOG_PENDING.md
@@ -3,4 +3,7 @@
 - Prevent errors from cascading.
   [#258](https://github.com/pulumi/pulumi-yaml/pull/258)
 
+- Move Pulumi YAML specification to the [Pulumi
+  documentation](https://www.pulumi.com/docs/reference/yaml). [#261](https://github.com/pulumi/pulumi-yaml/pull/261)
+
 ### Bug Fixes