Merge pull request #54335 from ChrisHowd/April-2026-Update-Generate-Docs-GH-Copilot

JamesJBarnett · web-flow · commit c28d5c83983b · 2026-04-21T10:10:16.000-07:00
Content refresh
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/1-introduction.yml b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/1-introduction.yml
@@ -4,7 +4,7 @@ title: Introduction
 metadata:
   title: Introduction
   description: "Introduction"
-  ms.date: 03/03/2026
+  ms.date: 04/16/2026
   author: chrishowd
   ms.author: cahowd
   ms.topic: unit
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/2-review-github-copilot-explain-document-features.yml b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/2-review-github-copilot-explain-document-features.yml
@@ -4,7 +4,7 @@ title: Review GitHub Copilot's "explain" and "document" features
 metadata:
   title: Review GitHub Copilot's "explain" and "document" features
   description: "Review GitHub Copilot's  explain  and  document  features"
-  ms.date: 03/03/2026
+  ms.date: 04/16/2026
   author: chrishowd
   ms.author: cahowd
   ms.topic: unit
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/3-examine-github-copilot-prompts-keywords.yml b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/3-examine-github-copilot-prompts-keywords.yml
@@ -4,7 +4,7 @@ title: Examine GitHub Copilot prompts and keywords
 metadata:
   title: Examine GitHub Copilot prompts and keywords
   description: "Examine GitHub Copilot prompts and keywords"
-  ms.date: 03/03/2026
+  ms.date: 04/16/2026
   author: chrishowd
   ms.author: cahowd
   ms.topic: unit
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/4-analyze-explain-code-using-github-copilot.yml b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/4-analyze-explain-code-using-github-copilot.yml
@@ -4,7 +4,7 @@ title: Analyze and explain code using GitHub Copilot
 metadata:
   title: Analyze and explain code using GitHub Copilot
   description: "Analyze and explain code using GitHub Copilot"
-  ms.date: 03/03/2026
+  ms.date: 04/16/2026
   author: chrishowd
   ms.author: cahowd
   ms.topic: unit
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/5-generate-project-documentation-using-github-copilot.yml b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/5-generate-project-documentation-using-github-copilot.yml
@@ -4,7 +4,7 @@ title: Generate project documentation using GitHub Copilot
 metadata:
   title: Generate project documentation using GitHub Copilot
   description: "Generate project documentation using GitHub Copilot"
-  ms.date: 03/03/2026
+  ms.date: 04/16/2026
   author: chrishowd
   ms.author: cahowd
   ms.topic: unit
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/6-generate-inline-code-documentation-using-github-copilot.yml b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/6-generate-inline-code-documentation-using-github-copilot.yml
@@ -4,7 +4,7 @@ title: Generate inline code documentation using GitHub Copilot
 metadata:
   title: Generate inline code documentation using GitHub Copilot
   description: "Generate inline code documentation using GitHub Copilot"
-  ms.date: 03/03/2026
+  ms.date: 04/16/2026
   author: chrishowd
   ms.author: cahowd
   ms.topic: unit
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/7-exercise-analyze-document-code-github-copilot.yml b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/7-exercise-analyze-document-code-github-copilot.yml
@@ -4,7 +4,7 @@ title: Exercise - Analyze and document code using GitHub Copilot
 metadata:
   title: Exercise - Analyze and document code using GitHub Copilot
   description: "Exercise - Analyze and document code using GitHub Copilot."
-  ms.date: 03/03/2026
+  ms.date: 04/16/2026
   author: chrishowd
   ms.author: cahowd
   ms.topic: unit
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/8-knowledge-check.yml b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/8-knowledge-check.yml
@@ -5,7 +5,7 @@ metadata:
   hidden_question_numbers: ["A1A8B431_10","A1A8B431_30","A1A8B431_6","A1A8B431_51","A1A8B431_55","A1A8B431_63","A1A8B431_67","A1A8B431_79","A1A8B431_104","A1A8B431_108","A1A8B431_112","A1A8B431_128","A1A8B431_88"]
   title: Module assessment
   description: "Knowledge check"
-  ms.date: 03/03/2026
+  ms.date: 04/16/2026
   author: chrishowd
   ms.author: cahowd
   ms.topic: unit
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/9-summary.yml b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/9-summary.yml
@@ -4,7 +4,7 @@ title: Summary
 metadata:
   title: Summary
   description: "Summary"
-  ms.date: 03/03/2026
+  ms.date: 04/16/2026
   author: chrishowd
   ms.author: cahowd
   ms.topic: unit
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/3-examine-github-copilot-prompts-keywords.md b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/3-examine-github-copilot-prompts-keywords.md
@@ -72,7 +72,7 @@ Examples using chat participant and variables combined with slash commands:
 - `#codebase /explain`: Generate an explanation of the full workspace.
 - `#codebase /fix` (or `/fix`): Propose a fix for the problems in the selected code.
 - `#codebase /tests` (or `/tests`): Generate unit tests for the selected code.
-- `@vscode /api` (or `/api`): Ask about Visual Studio Code extension development.
+- `@vscode`: Ask questions about VS Code features, settings, and extension APIs. For example: `@vscode how to enable word wrapping?`
 - `#codebase /new` (or `/new`): Scaffold code for a new workspace.
 - `#codebase /newNotebook` (or `/newNotebook`): Create a new Jupyter Notebook.
 
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/4-analyze-explain-code-using-github-copilot.md b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/4-analyze-explain-code-using-github-copilot.md
@@ -21,7 +21,7 @@ You can use the Chat view in Ask agent mode for a wide range of topics. For exam
 - Propose code fixes ("`#codebase /fix`", "`This method gives a FileNotFoundException`")
 - Ask about VS Code settings ("`@vscode how do I disable the minimap?`")
 
-![Screenshot showing the Chat view asking about the Singleton pattern.](../media/explain-chat-view-workspace-explain-singleton-pattern.png)
+![Screenshot showing the Chat view asking about the Singleton pattern.](../media/explain-chat-view-slash-explain-singleton-pattern.png)
 
 The Ask agent mode supports the following interface features:
 
@@ -33,7 +33,7 @@ The Ask agent mode supports the following interface features:
 
 - Ask Copilot: The Ask Copilot text box is where you enter your prompts. When you're using Ask agent mode, prompts can include chat participants, slash commands, and chat variables.
 
-    In Ask agent mode, you can use chat participants to specify the context of your questions. For example, you can use `@workspace` to indicate that the context is your workspace files.
+    In Ask agent mode, you can use chat participants to specify the context of your questions. You can also add `#codebase` to your prompt to include the full workspace as context.
 
 - Start Voice Chat button: The Start Voice Chat button is located to the left of the Ask Copilot textbox. You can use this button to enable or disable voice interactions with GitHub Copilot. When voice interactions are enabled, you can use your voice to ask GitHub Copilot questions.
 
@@ -71,7 +71,7 @@ The inline chat supports the following features:
 
 The Explain smart action is used to explain code that's open in the editor. You can narrow the focus by selecting a code block, a single code line, or a variable. When there's no code selected, the explanation refers to the active file. The Explain smart action displays responses in the Chat view.
 
-To access the Explain smart action, you can right-click in the active code editor, select **Copilot**, and then select **Explain**.
+To access the Explain smart action, you can right-click in the active code editor and then select **Explain**.
 
 ![Screenshot showing the Explain smart action in the context menu.](../media/explain-smart-action-explain.png)
 
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/6-generate-inline-code-documentation-using-github-copilot.md b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/6-generate-inline-code-documentation-using-github-copilot.md
@@ -63,7 +63,7 @@ The Chat view in Plan mode can be used to create a detailed plan for generating
     For example, you can enter the following prompt:
 
     ```plaintext
-    Create a plan for adding inline code documentation to the ConsoleApp class. Document the class, its properties, and methods. Identify all files that need documentation updates.
+    Create a plan for adding inline code documentation to the codebase. Document classes, properties, and methods. Identify all files that need documentation updates.
     ```
 
 1. Review the implementation plan.
@@ -116,28 +116,6 @@ The Chat view in Agent mode can be used to generate inline code documentation fo
 
     You can continue to update the documentation as needed in the code editor.
 
-## Generate inline code documentation using the "Generate Docs" smart action
-
-The **Generate Docs** smart action can be used to generate inline code documentation for classes, methods, or complex code blocks. It's a quick way to generate documentation without needing to write a prompt. The **Generate Docs** smart action is available in the context menu when you right-click selected code in the editor.
-
-The **Generate Docs** smart action suggests inline code documentation directly in the code editor.
-
-1. Open the code file in the editor.
-
-1. Select the code that you want to document.
-
-1. Right-click the selected code, select **Copilot**, and then select the **Generate Docs** smart action.
-
-    ![Screenshot showing the Generate Docs smart action.](../media/smart-action-generate-docs-may-2025.png)
-
-1. Review the suggested inline code documentation in the editor.
-
-    ![Screenshot showing the code documentation suggested by the Generate Docs smart action.](../media/smart-action-generate-docs-may-2025-accept-updates.png)
-
-1. Use the **Accept** button accept the suggested update or **Close** to reject the update.
-
-    You can also use the **Rerun** button to rerun the prompt with or without updates.
-
 ## Generate inline code documentation using inline chat
 
 The inline chat feature can be used to generate inline code documentation for classes, methods, or complex code blocks. The prompt is used to specify context or to provide specific instructions. You can also use the `/doc` slash command without a text prompt if you want.
@@ -168,6 +146,27 @@ Inline chat suggests inline code documentation directly in the code editor.
 
     You can also use the **Rerun** button to rerun the prompt with or without updates.
 
+## Generate inline code documentation using the "Generate Docs" smart action
+
+The **Generate Docs** smart action can be used to generate inline code documentation for classes, methods, or complex code blocks. It's a quick way to generate documentation without needing to write a prompt. The **Generate Docs** smart action is available in the context menu when you right-click selected code in the editor.
+
+The **Generate Docs** smart action suggests inline code documentation directly in the code editor.
+
+1. Open the code file in the editor.
+
+1. Select the code that you want to document.
+
+1. Right-click the selected code, select **Generate Code**, and then select **Generate Docs**.
+
+1. Review the suggested inline code documentation in the editor.
+
+1. Use the **Accept** button accept the suggested update or **Close** to reject the update.
+
+    You can also use the **Rerun** button to rerun the prompt with or without updates.
+
+> [!NOTE]
+> If the **Generate Code > Generate Docs** smart action isn't available, use the inline chat feature or Chat view to generate documentation.
+
 ### Summary
 
 GitHub Copilot helps you generate inline code documentation quickly and accurately. The Chat view, inline chat, and smart action features provide various levels of interaction directly within the Visual Studio Code environment.
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/index.yml b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/index.yml
@@ -3,7 +3,7 @@ uid: learn.wwl.generate-documentation-using-github-copilot-tools
 metadata:
   title: Generate Documentation Using GitHub Copilot Tools
   description: "This module explores the generation of code explanations, project documentation, and inline code comment documentation using the GitHub Copilot Chat extension for Visual Studio Code."
-  ms.date: 03/03/2026
+  ms.date: 04/16/2026
   author: chrishowd
   ms.author: cahowd
   ms.topic: module-standard-task-based
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/media/explain-chat-view-slash-explain-singleton-pattern.png b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/media/explain-chat-view-slash-explain-singleton-pattern.png
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/media/explain-chat-view-workspace-explain-singleton-pattern.png b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/media/explain-chat-view-workspace-explain-singleton-pattern.png
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/media/explain-smart-action-explain.png b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/media/explain-smart-action-explain.png
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/media/smart-action-generate-docs-may-2025-accept-updates.png b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/media/smart-action-generate-docs-may-2025-accept-updates.png
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/media/smart-action-generate-docs-may-2025.png b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/media/smart-action-generate-docs-may-2025.png
