From bc15d4f9bcaccb87ed62effab14ee2bf1456c4e7 Mon Sep 17 00:00:00 2001
From: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
Date: Tue, 15 Nov 2022 19:15:34 +0000
Subject: [PATCH] Make definition anchors more unique (#1339)

Stick a `definition-` on the front of the autogenerated anchors for definition
blocks.

This solves a problem where, for example,
https://spec.matrix.org/unstable/application-service-api/#registration could
refer to either the "Registration" section or the `Registration` definition
therein.

(These anchors are relatively recent: they were added in #1191.
---
 changelogs/internal/newsfragments/1339.clarification | 1 +
 layouts/shortcodes/definition.html                   | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)
 create mode 100644 changelogs/internal/newsfragments/1339.clarification

diff --git a/changelogs/internal/newsfragments/1339.clarification b/changelogs/internal/newsfragments/1339.clarification
new file mode 100644
index 000000000..8c5af2e21
--- /dev/null
+++ b/changelogs/internal/newsfragments/1339.clarification
@@ -0,0 +1 @@
+Make definition anchors more unique.
diff --git a/layouts/shortcodes/definition.html b/layouts/shortcodes/definition.html
index 02f2c6b06..7ed2678a4 100644
--- a/layouts/shortcodes/definition.html
+++ b/layouts/shortcodes/definition.html
@@ -30,7 +30,7 @@
 {{ $definition = partial "json-schema/resolve-refs" (dict "schema" $definition "path" $path) }}
 {{ $definition = partial "json-schema/resolve-allof" $definition }}
 
-<section class="rendered-data definition" id="{{ anchorize $definition.title }}">
+<section class="rendered-data definition" id="definition-{{ anchorize $definition.title }}">
 
 <details {{ if not $compact }}open{{ end }}>
 <summary>