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