diff --git a/layouts/docs/changelog.html b/layouts/docs/changelog.html
index c6bb9020..94fa55a3 100644
--- a/layouts/docs/changelog.html
+++ b/layouts/docs/changelog.html
@@ -33,6 +33,10 @@
     <table class="release-info">
         {{ $rev := $version }}
         {{ if eq $version "unstable" -}}
+            {{- /*
+                Extract the git SHA from the frontmatter of the changelog, where
+                it was stashed by `generate-changelog.sh`.
+            */ -}}
             {{ $rev = .Params.commit -}}
         {{ end -}}
         {{ $commitLink := printf "https://github.com/matrix-org/matrix-spec/tree/%s" $rev -}}