diff --git a/.github/agents/docseditor.agent.md b/.github/agents/docseditor.agent.md index 68309d47ac9da..43ca3d27e5116 100644 --- a/.github/agents/docseditor.agent.md +++ b/.github/agents/docseditor.agent.md @@ -40,7 +40,6 @@ You are performing an edit pass on a Microsoft documentation article. Your MANDA 2. **AI Disclosure**: If the `ai-usage` frontmatter is missing, add `ai-usage: ai-assisted`. 3. **Preserve Meaning**: Never change the technical meaning or accuracy of content. 4. **Markdown Structure**: Maintain existing markdown formatting and structure. -5. **Mandatory style**: End list items with periods if more than three words - **THIS IS NON-NEGOTIABLE**. ## MANDATORY TRANSFORMATIONS - Apply These Aggressively @@ -163,7 +162,6 @@ When editing, focus on these areas in order of priority: **ALWAYS fix punctuation:** - Remove colons from headings: ❌ "Next steps:" → ✅ "Next steps" -- Periods in lists: Use periods for complete sentences over 3 words - ❌ "Prerequisites." → ✅ "Prerequisites" (for short list items) **ALWAYS use proper formatting:** @@ -205,7 +203,6 @@ When editing, focus on these areas in order of priority: - ALWAYS use Oxford comma: "Android, iOS, and Windows" - ALWAYS number ordered lists as "1." for all items (not 1., 2., 3.) - ALWAYS use ordered lists for sequential procedural steps and ALWAYS use unordered lists for everything else -- ALWAYS use periods for complete sentences in lists (if more than 3 words) - ALWAYS replace "etc." with "for example" or complete the list ### Spacing and Punctuation diff --git a/.github/instructions/Markdown.WritingStyle.instructions.md b/.github/instructions/Markdown.WritingStyle.instructions.md index aae5e7b106622..045c291e0e7fa 100644 --- a/.github/instructions/Markdown.WritingStyle.instructions.md +++ b/.github/instructions/Markdown.WritingStyle.instructions.md @@ -41,7 +41,6 @@ ALWAYS: - **MANDATORY: Number ordered lists using "1." for every item (NOT 1., 2., 3.) - ALWAYS USE "1."** - **REQUIRED: Use bullets for unordered lists - NEVER use numbers for unordered content** - **ESSENTIAL: Write complete sentences in lists with proper punctuation** -- **MUST: End list items with periods if more than three words. The period may be inside style marks like `*` for italic or `**` for bold - THIS IS NON-NEGOTIABLE** - Skip end punctuation on titles, headings, and UI elements (3 words or fewer) ### Spacing and Layout @@ -80,4 +79,4 @@ Apply these formatting rules: ### Contraction Guidelines - Use common contractions: "it's," "you're," "that's," "don't" - Avoid ambiguous contractions: "there'd," "it'll," "they'd" -- Never form contractions from noun + verb (avoid "Microsoft's developing") \ No newline at end of file +- Never form contractions from noun + verb (avoid "Microsoft's developing")