diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 7e2471e335296..174e209381cfa 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -40,8 +40,8 @@ If unsure, use API browser: `https://learn.microsoft.com/api/apibrowser/dotnet/s Use the following rules to encode special characters in API doc IDs: -1. Encode `#` as `%23` in API doc IDs. For example, `System.String.#ctor` becomes `System.String.%23ctor`. -2. **DO NOT** encode `*` or \` (backtick) characters as `%2A` or `%60` respectively. +- Encode `#` as `%23` in API doc IDs. For example, `System.String.#ctor` becomes `System.String.%23ctor`. +- **DO NOT** encode `*` or \` (backtick) characters as `%2A` or `%60` respectively. ## Code Snippets diff --git a/.github/instructions/Markdown.WritingStyle.instructions.md b/.github/instructions/Markdown.WritingStyle.instructions.md index 39e71b578e3ca..68a4c78975619 100644 --- a/.github/instructions/Markdown.WritingStyle.instructions.md +++ b/.github/instructions/Markdown.WritingStyle.instructions.md @@ -39,6 +39,7 @@ ALWAYS: ### Lists and Punctuation - **CRITICAL: Use Oxford comma in ALL lists (item1, item2, and item3) - NO EXCEPTIONS** +- **MANDATORY: Use ordered lists ONLY for sequential procedural steps - NEVER for non-procedural content** - **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**