diff options
-rw-r--r-- | appendices/contributing/text.xml | 5 | ||||
-rw-r--r-- | appendices/devbook-guide/text.xml | 7 |
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><d/></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 : <uri link = "https://www.gentoo.org/"> Correct: <uri link="https://www.gentoo.org/"> </codesample> +<p> +<b>Dashes</b> used as in-sentence punctuation <d/> like this <d/> should be +written as a <c><d/></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> |