Merge pull request #8804 from microsoft/docs-instructions

Update docs prompts and instructions

Author: ntrogh

.github/instructions/docs-writing.instructions.md

@@ -47,6 +47,8 @@ These are our documentation writing style guidelines.
 * Avoid semicolons - use separate sentences instead.
 * Use question marks sparingly.
 * Don't use slashes (/) - use "or" instead.
+* Prefer single over double quotes, avoiding typographic quotes.
+* Only use apostrophe (U+0027) and quotes (U+0022), not left or right single or double quotation marks.
 
 ## Text formatting
 
@@ -85,13 +87,19 @@ These are our documentation writing style guidelines.
 * Images have a descriptive and meaningful alt text that starts with "Screenshot showing" and ends with ".".
 * Videos have a descriptive and meaningful alt text or title that starts with "Video showing" and ends with ".".
 
+## Lists
+
+* Use asterisks (*) for lists of items.
+* Use numbered lists for steps in a procedure.
+* Keep list items parallel in structure.
+
 ## Numbered steps
 
 * Write complete sentences with capitalization and periods
 * Use imperative verbs
 * Clearly indicate where actions take place (UI location)
 * For single steps, use a bullet instead of a number
-* When allowed, use angle brackets for menu sequences (File > Open)
+* Use angle brackets for menu sequences (File > Open)
 
 ## Terminology
 

.github/prompts/askvscode.prompt.md

@@ -1,6 +1,10 @@
 ---
 mode: agent
 model: Claude Sonnet 4
-tools: ['codebase', 'vscodeAPI', 'githubRepo', 'search']
+tools: ['codebase', 'usages', 'vscodeAPI', 'githubRepo', 'search']
 ---
 You are an expert in answering questions about Visual Studio Code, its features, and how to use it effectively. Explain how specific features work, give examples of usage scenarios.
+
+Ground your answers in the source code by using #githubRepo microsoft/vscode and microsoft/vscode-copilot-chat.
+
+Provide references to where you found the information in the source code.

.github/prompts/review-article.prompt.md

@@ -1,6 +1,6 @@
 ---
 mode: agent
-tools: ['codebase', 'vscodeAPI', 'problems', 'fetch', 'search']
+tools: ['codebase', 'vscodeAPI', 'problems', 'fetch', 'search', 'githubRepo']
 description: You are a technical writer reviewing an article for clarity, conciseness, and adherence to the documentation writing style guidelines.
 ---
 Review the article for clarity, conciseness, and adherence to our documentation [writing style guidelines](../instructions/docs-writing.instructions.md).