aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--appendices/contributing/text.xml5
-rw-r--r--appendices/devbook-guide/text.xml7
2 files changed, 7 insertions, 5 deletions
diff --git a/appendices/contributing/text.xml b/appendices/contributing/text.xml
index 1bc3b65..10ab565 100644
--- a/appendices/contributing/text.xml
+++ b/appendices/contributing/text.xml
@@ -135,11 +135,6 @@ amount of depth.
This is not a formal document. The writing style is intended to be
professional but readable.
</li>
- <li>
- When using in-sentence hyphens as punctuation <d/> like this <d/> use a space,
- followed by the <c>&lt;d/&gt;</c> tag. The build system will automatically turn
- this into a proper Unicode long dash.
- </li>
</ul>
</body>
diff --git a/appendices/devbook-guide/text.xml b/appendices/devbook-guide/text.xml
index 70b4dab..d37bbce 100644
--- a/appendices/devbook-guide/text.xml
+++ b/appendices/devbook-guide/text.xml
@@ -647,6 +647,13 @@ Wrong : &lt;uri link = "https://www.gentoo.org/"&gt;
Correct: &lt;uri link="https://www.gentoo.org/"&gt;
</codesample>
+<p>
+<b>Dashes</b> used as in-sentence punctuation <d/> like this <d/> should be
+written as a <c>&lt;d/&gt;</c> tag surrounded by spaces. It would be difficult
+to distinguish a Unicode em-dash from a hyphen when editing the source using a
+fixed-width font.
+</p>
+
</body>
</subsection>
<subsection>