From 790813b3b9f20ed30294173a0ff053d5df842ce4 Mon Sep 17 00:00:00 2001 From: Bill Wagner Date: Thu, 13 Nov 2025 15:55:31 -0500 Subject: [PATCH 1/2] List punctuation requirements While lists do need to end in a period, that period may be inside style marks like `*`, `**`, or `***` --- .github/instructions/Markdown.WritingStyle.instructions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/instructions/Markdown.WritingStyle.instructions.md b/.github/instructions/Markdown.WritingStyle.instructions.md index 2857d9d7fcaeb..07f873eb24a62 100644 --- a/.github/instructions/Markdown.WritingStyle.instructions.md +++ b/.github/instructions/Markdown.WritingStyle.instructions.md @@ -41,7 +41,7 @@ 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 - THIS IS NON-NEGOTIABLE** +- **MUST: End list items with periods if more than three words. Note that 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 From a4d135c493e6e1b237cdd4108cbb4f197348e54e Mon Sep 17 00:00:00 2001 From: Bill Wagner Date: Thu, 13 Nov 2025 16:35:12 -0500 Subject: [PATCH 2/2] Update .github/instructions/Markdown.WritingStyle.instructions.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .github/instructions/Markdown.WritingStyle.instructions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/instructions/Markdown.WritingStyle.instructions.md b/.github/instructions/Markdown.WritingStyle.instructions.md index 07f873eb24a62..aae5e7b106622 100644 --- a/.github/instructions/Markdown.WritingStyle.instructions.md +++ b/.github/instructions/Markdown.WritingStyle.instructions.md @@ -41,7 +41,7 @@ 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. Note that the period may be inside style marks like `*` for italic or `**` for bold. - THIS IS NON-NEGOTIABLE** +- **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