diff --git a/docs/format-changelog.rst b/docs/format-changelog.rst
index 15941cb..f093741 100644
--- a/docs/format-changelog.rst
+++ b/docs/format-changelog.rst
@@ -137,7 +137,10 @@ Version 14
 Added
 ~~~~~
 
-- The ``overrides`` top-level entry can be used to pin floating repo refspecs.
+- The keys ``commit`` and ``branch`` are introduced as replacement of
+  ``refspec`` in ``repos`` and ``defaults``. ``refspec`` is now deprecated and
+  will eventually be removed.
+- The ``overrides`` top-level entry can be used to pin floating repo branches.
 - ``_source_dir`` top-level entry is auto-generated when using the menu plugin
   and provides the path to the top repo at time of invoking the plugin.
 - ``_source_dir_host`` top-level entry is auto-generated by kas-container to