aboutsummaryrefslogtreecommitdiff
path: root/spec/STYLE.md
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2023-11-20 19:27:51 +0000
committerIan Jackson <iwj@torproject.org>2023-11-20 19:27:51 +0000
commit189b6216967f264318501c9aefb5587a9ee2ff82 (patch)
tree9a370da00acfa7d70f05d0420d9a7c2839e35962 /spec/STYLE.md
parentbf8ddd700c33b191df70102df74a2c47bf0ed376 (diff)
downloadtorspec-189b6216967f264318501c9aefb5587a9ee2ff82.tar.gz
torspec-189b6216967f264318501c9aefb5587a9ee2ff82.zip
STYLE: Clarify recommendation about span
Diffstat (limited to 'spec/STYLE.md')
-rw-r--r--spec/STYLE.md4
1 files changed, 2 insertions, 2 deletions
diff --git a/spec/STYLE.md b/spec/STYLE.md
index b5efa61..0596e3d 100644
--- a/spec/STYLE.md
+++ b/spec/STYLE.md
@@ -150,9 +150,9 @@ the anchor that says `<a id="dir-spec.txt-2.1.3"></a>`.
### Define link fragment targets with `<span id="...">` (usually)
-To manually make an target for a `#` link fragment,
+To manually make an target for a `#`-prefixed link fragment,
prefer `<span id="fragment">Text</span>`,
-to `<a id=...>`.
+to `<a id=...>Text</a>`.
This works around mdbook mistakenly styling
`<a>` without `href`
as if it were a clickable link.