[gentoo-commits] proj/devmanual:master commit in: appendices/devbook-guide/, appendices/contributing/

[gentoo-commits] proj/devmanual:master commit in: appendices/devbook-guide/, appendices/contributing/

[Ulrich Müller]

commit:     ba881fa1e70cf15082b6130080b9c799c8c491cc
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Mon Feb 15 07:48:30 2021 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Mon Feb 15 07:48:30 2021 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=ba881fa1

devbook-guide: Note about dashes moved from contributing to here

Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 appendices/contributing/text.xml  | 5 -----
 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>&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>