From 676cfce8b4ac655871217b8d2aa898652f4902e1 Mon Sep 17 00:00:00 2001 From: "Andy De George (from Dev Box)" Date: Fri, 10 Apr 2026 15:02:34 -0700 Subject: [PATCH 1/2] Coerce copilot to avoid emdash everywhere --- .github/agents/docseditor.agent.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.github/agents/docseditor.agent.md b/.github/agents/docseditor.agent.md index 10d38c0d949e8..1a08ddb353fc9 100644 --- a/.github/agents/docseditor.agent.md +++ b/.github/agents/docseditor.agent.md @@ -230,6 +230,9 @@ When editing, focus on these areas in order of priority: - ALWAYS use one space after periods, colons, question marks - ALWAYS use no spaces around dashes: "Use pipelines—logical groups—to consolidate" - ALWAYS add blank lines around markdown elements (don't add extra if they exist) +- TRY to avoid emdash and the various alternative dash characters; try to use other punctuation or formatting to achieve the same effect. Choose words over characters when possible +- OK to use compound adjectives with hyphens +- OK to use emdash mid-sentence for a clause or example; use sparingly ## API REFERENCES From 43cc81393d6bbb695e03bc419a6b8fb4284fb465 Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Mon, 20 Apr 2026 10:34:17 -0700 Subject: [PATCH 2/2] Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .github/agents/docseditor.agent.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/.github/agents/docseditor.agent.md b/.github/agents/docseditor.agent.md index 1a08ddb353fc9..c3352d8353869 100644 --- a/.github/agents/docseditor.agent.md +++ b/.github/agents/docseditor.agent.md @@ -228,11 +228,10 @@ When editing, focus on these areas in order of priority: ### Spacing and Punctuation - ALWAYS use one space after periods, colons, question marks -- ALWAYS use no spaces around dashes: "Use pipelines—logical groups—to consolidate" - ALWAYS add blank lines around markdown elements (don't add extra if they exist) -- TRY to avoid emdash and the various alternative dash characters; try to use other punctuation or formatting to achieve the same effect. Choose words over characters when possible -- OK to use compound adjectives with hyphens -- OK to use emdash mid-sentence for a clause or example; use sparingly +- TRY to avoid em dashes (—) where possible; prefer other punctuation, formatting, or clearer wording +- If you must use an em dash (—), use no spaces around it: "Use pipelines—logical groups—to consolidate" +- OK to use hyphens (-) in compound adjectives ## API REFERENCES