Commit 217a75e
committed
Add version-stable anchors to the release notes template.
The current template embeds anchors from subheadings like "Compiler" that have
the same section subheading name; thus, the generated html ends up with `id`
attributes that have been uniquified (by adding a incremented suffix, e.g.
`#compiler-2`) but those `id` attributes will change (e.g. to `#compiler-3`) as
new releases come out.
The change in this PR enables one to write urls that end with e.g.
`#1.66.0-Compiler` and have that url remain usable (in terms of pointing to the
compiler subsection *for that release*), even in face of future releases.
FYI: in my local experimentation, it appears that in the context of hackmd,
visiting an anchor tag with no contents will end up scrolling to a point where
the hackmd toolbar obscures the subsection heading. This is unfortunate (though
still an improvement on the current state of affairs where one has *no option*
to link directly to these subsections in a version-stable manner). I am hoping
that there is not a similar problem for the RELEASES.md file when viewed on
github itself.1 parent b7e58f4 commit 217a75e
1 file changed
+16
-0
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
| 4 | + | |
| 5 | + | |
4 | 6 | | |
5 | 7 | | |
6 | 8 | | |
| |||
9 | 11 | | |
10 | 12 | | |
11 | 13 | | |
| 14 | + | |
| 15 | + | |
12 | 16 | | |
13 | 17 | | |
14 | 18 | | |
| |||
17 | 21 | | |
18 | 22 | | |
19 | 23 | | |
| 24 | + | |
| 25 | + | |
20 | 26 | | |
21 | 27 | | |
22 | 28 | | |
| |||
25 | 31 | | |
26 | 32 | | |
27 | 33 | | |
| 34 | + | |
| 35 | + | |
28 | 36 | | |
29 | 37 | | |
30 | 38 | | |
| 39 | + | |
| 40 | + | |
31 | 41 | | |
32 | 42 | | |
33 | 43 | | |
| |||
36 | 46 | | |
37 | 47 | | |
38 | 48 | | |
| 49 | + | |
| 50 | + | |
39 | 51 | | |
40 | 52 | | |
41 | 53 | | |
| 54 | + | |
| 55 | + | |
42 | 56 | | |
43 | 57 | | |
44 | 58 | | |
| |||
47 | 61 | | |
48 | 62 | | |
49 | 63 | | |
| 64 | + | |
| 65 | + | |
50 | 66 | | |
51 | 67 | | |
52 | 68 | | |
| |||
0 commit comments