Skip to content

Remove list item period guidance #50388

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gewarren merged 2 commits into from
Dec 8, 2025
Merged

Remove list item period guidance #50388

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
697350b
Remove list period guidance
gewarren Dec 8, 2025
2635cc0
Update Markdown writing style instructions
gewarren Dec 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 0 additions & 3 deletions .github/agents/docseditor.agent.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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:**
Expand Down Expand Up @@ -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
Expand Down
3 changes: 1 addition & 2 deletions .github/instructions/Markdown.WritingStyle.instructions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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")
- Never form contractions from noun + verb (avoid "Microsoft's developing")