From 4b6600a3abf50b16e2eb40f9873ade1271913446 Mon Sep 17 00:00:00 2001 From: cyqsimon <28627918+cyqsimon@users.noreply.github.com> Date: Sun, 5 Jan 2025 02:53:31 +0800 Subject: [PATCH] style-guide: recommend hyphen over en dash and em dash (#15407) Co-authored-by: Wiktor Perskawiec Co-authored-by: Juri Dispan Co-authored-by: K.B.Dharun Krishna Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> --- contributing-guides/style-guide.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/contributing-guides/style-guide.md b/contributing-guides/style-guide.md index 92f517ff32..dc2fddb763 100644 --- a/contributing-guides/style-guide.md +++ b/contributing-guides/style-guide.md @@ -468,7 +468,20 @@ When documenting optional placeholders like paths or file extensions, it is sugg ## Language-Specific Rules -The below section contains additional language-specific rules for translating pages: +The below section contains additional language-specific rules: + +### English-Specific Rules + +A normal hyphen (`-`) should be used in places where various style guides may recommend en dash (`–`) or em dash (`—`). + +- For example, use `for lengths 3-12` rather than `for lengths 3–12` + +The reason for this is four-fold: + +1. There is no widely accepted standard among various style guides on when each of these dashes should be used. +2. Hyphen (`-`) is the only dash-like character in ASCII, which reduces the likelihood of compatibility issues. +3. Hyphen (`-`) is by far the easiest to type. +4. Many English speakers, especially non-native ones, are not aware of the difference. ### Chinese-Specific Rules