Skip to content

Commit f728d04

Browse files
authored
Remove list item period guidance (#50388)
* Remove list period guidance Removed non-negotiable rule about list item punctuation. * Update Markdown writing style instructions
1 parent b3989ee commit f728d04

File tree

2 files changed

+1
-5
lines changed

2 files changed

+1
-5
lines changed

.github/agents/docseditor.agent.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,6 @@ You are performing an edit pass on a Microsoft documentation article. Your MANDA
4040
2. **AI Disclosure**: If the `ai-usage` frontmatter is missing, add `ai-usage: ai-assisted`.
4141
3. **Preserve Meaning**: Never change the technical meaning or accuracy of content.
4242
4. **Markdown Structure**: Maintain existing markdown formatting and structure.
43-
5. **Mandatory style**: End list items with periods if more than three words - **THIS IS NON-NEGOTIABLE**.
4443

4544
## MANDATORY TRANSFORMATIONS - Apply These Aggressively
4645

@@ -163,7 +162,6 @@ When editing, focus on these areas in order of priority:
163162

164163
**ALWAYS fix punctuation:**
165164
- Remove colons from headings: ❌ "Next steps:" → ✅ "Next steps"
166-
- Periods in lists: Use periods for complete sentences over 3 words
167165
- ❌ "Prerequisites." → ✅ "Prerequisites" (for short list items)
168166

169167
**ALWAYS use proper formatting:**
@@ -205,7 +203,6 @@ When editing, focus on these areas in order of priority:
205203
- ALWAYS use Oxford comma: "Android, iOS, and Windows"
206204
- ALWAYS number ordered lists as "1." for all items (not 1., 2., 3.)
207205
- ALWAYS use ordered lists for sequential procedural steps and ALWAYS use unordered lists for everything else
208-
- ALWAYS use periods for complete sentences in lists (if more than 3 words)
209206
- ALWAYS replace "etc." with "for example" or complete the list
210207

211208
### Spacing and Punctuation

.github/instructions/Markdown.WritingStyle.instructions.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,6 @@ ALWAYS:
4141
- **MANDATORY: Number ordered lists using "1." for every item (NOT 1., 2., 3.) - ALWAYS USE "1."**
4242
- **REQUIRED: Use bullets for unordered lists - NEVER use numbers for unordered content**
4343
- **ESSENTIAL: Write complete sentences in lists with proper punctuation**
44-
- **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**
4544
- Skip end punctuation on titles, headings, and UI elements (3 words or fewer)
4645

4746
### Spacing and Layout
@@ -80,4 +79,4 @@ Apply these formatting rules:
8079
### Contraction Guidelines
8180
- Use common contractions: "it's," "you're," "that's," "don't"
8281
- Avoid ambiguous contractions: "there'd," "it'll," "they'd"
83-
- Never form contractions from noun + verb (avoid "Microsoft's developing")
82+
- Never form contractions from noun + verb (avoid "Microsoft's developing")

0 commit comments

Comments
 (0)