changed files by pdets auto publish service, publishid[f67cb6bd-7d3f-4423-a24e-6e7d25af5d3e] and do [publish].

wwlpublish · web-flow · commit febd381c58e4 · 2025-05-25T01:32:23.000+08:00
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: 05/23/2025
+  ms.date: 05/24/2025
   author: wwlpublish
   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: 05/23/2025
+  ms.date: 05/24/2025
   author: wwlpublish
   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: 05/23/2025
+  ms.date: 05/24/2025
   author: wwlpublish
   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: 05/23/2025
+  ms.date: 05/24/2025
   author: wwlpublish
   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: 05/23/2025
+  ms.date: 05/24/2025
   author: wwlpublish
   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: 05/23/2025
+  ms.date: 05/24/2025
   author: wwlpublish
   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: 05/23/2025
+  ms.date: 05/24/2025
   author: wwlpublish
   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
@@ -4,7 +4,7 @@ title: Module assessment
 metadata:
   title: Module assessment
   description: "Knowledge check"
-  ms.date: 05/23/2025
+  ms.date: 05/24/2025
   author: wwlpublish
   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: 05/23/2025
+  ms.date: 05/24/2025
   author: wwlpublish
   ms.author: cahowd
   ms.topic: unit
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/2-review-github-copilot-explain-document-features.md b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/2-review-github-copilot-explain-document-features.md
@@ -4,7 +4,7 @@ GitHub Copilot makes it easier for developers to work with complex or unfamiliar
 
 The following GitHub Copilot features can be used to analyze and explain code:
 
-- Chat view in Ask mode: Analyze your entire workspace and ask questions about coding topics, technology concepts, and general programming practices.
+- Ask mode: Use the Chat view in ask mode to analyze your entire workspace and ask questions about coding topics, technology concepts, and general programming practices.
 
 - Inline Chat: Start an inline chat session directly from the editor to ask about specific code sections.
 
@@ -16,11 +16,11 @@ The following GitHub Copilot features can be used to analyze and explain code:
 
 The following GitHub Copilot features can be used to generate inline code documentation:
 
-- Chat view in Ask mode: Use the Ask mode to suggest inline code documentation for a code file, class, or method. Review the suggested inline documentation in the Chat view. Request updates as needed in the chat conversation. Once you're satisfied with the proposed documentation, you can insert the suggested documentation into the corresponding code file.
+- Ask mode: Use the ask mode to suggest inline code documentation for a code file, class, or method. Review the suggested inline documentation in the Chat view. Request updates as needed in the chat conversation. Once you're satisfied with the proposed documentation, you can insert the suggested documentation into the corresponding code file.
 
-- Chat view in Edit mode: Use the Edit mode to suggest inline code documentation for a code file, class, or method. Review the suggested documentation in the editor, navigating between suggested updates. Accept or reject individual suggestions, or modify suggestions as needed.
+- Edit mode: Use the edit mode to suggest inline code documentation for a code file, class, or method. Review the suggested documentation in the editor, navigating between suggested updates. Accept or reject individual suggestions, or modify suggestions as needed.
 
-- Chat view in Agent mode: Use the Agent mode to autonomously generate inline code documentation for specified code projects, files, classes, or methods. Have the agent perform additional tasks during or after the documentation process. Accept or reject the updates when the agent has completed the assigned tasks.
+- Agent mode: Use the agent mode to autonomously generate inline code documentation for specified code projects, files, classes, or methods. Have the agent perform additional tasks during or after the documentation process. Accept or reject the updates when the agent has completed the assigned tasks.
 
 - Inline chat - Use an inline chat session to work directly in the code editor. The inline chat is useful when you want to document specific code (classes, methods, or code blocks) without leaving the editor. You can provide specific instructions in the prompt or use the `/doc` slash command without additional information if you want. Updates are displayed in the code editor and can be accepted or rejected. You can also choose the option to rerun the prompt with or without updates.
 
@@ -30,14 +30,14 @@ The following GitHub Copilot features can be used to generate inline code docume
 
 The following GitHub Copilot features can be used to generate project documentation:
 
-- Chat view in Ask mode: Use the Ask mode to analyze the codebase and gain an understanding of the code projects, files, and classes. Use Ask mode to preview suggested project documentation. Review suggestions and request updates or additional details as needed. Insert the suggested documentation into a project documentation file (README.md).
+- Chat view in ask mode: Use the ask mode to analyze the codebase and gain an understanding of the code projects, files, and classes. Use ask mode to preview suggested project documentation. Review suggestions and request updates or additional details as needed. Insert the suggested documentation into a project documentation file (README.md).
 
 - Chat view in Edit mode: Generate a project documentation file (README.md).
 
-- Chat view in Agent mode: Generate a collection of project documentation files: create/update the README.md, create/update the UsageExamples.md, and create/update the ChangeLog.md. Include links between the documentation files, cross-reference classes and methods, and ensure consistency across docs.
+- Chat view in agent mode: Generate a collection of project documentation files: create/update the README.md, create/update the UsageExamples.md, and create/update the ChangeLog.md. Include links between the documentation files, cross-reference classes and methods, and ensure consistency across docs.
 
 > [!IMPORTANT]
-> When you use the Chat view in Agent mode, GitHub Copilot may make multiple premium requests to complete a single task. This includes both user-initiated prompts and follow-up actions Copilot takes on your behalf. The total premium requests used will depend on the complexity of the task, the number of steps involved, and the model selected.
+> When you use the Chat view in agent mode, GitHub Copilot may make multiple premium requests to complete a single task. This includes both user-initiated prompts and follow-up actions Copilot takes on your behalf. The total premium requests used will depend on the complexity of the task, the number of steps involved, and the model selected.
 
 ## Summary
 
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
@@ -8,7 +8,7 @@ When you write prompts for GitHub Copilot, consider the following guidelines to
 
 - When you need to write a longer prompt, the prompt should be written using several short sentences. Start with an overview that describes your goal and then provide specific details.
 
-- Consider breaking complex prompts into smaller, more manageable parts. This helps the AI to understand your intent and provide more accurate responses. Subsequent prompts can build on the previous ones, allowing you to refine your request and get more specific answers. Working with the peer programmer is similar to working with a person. It's better to frame your conversation first, and then describe the specific details rather than sending everything in a single request that may be misinterpreted.
+- Consider breaking complex prompts into smaller, more manageable parts. Breaking down complex prompts helps the AI to understand your intent and provide more accurate responses. Subsequent prompts can build on the previous ones, allowing you to refine your request and get more specific answers. Working with the peer programmer is similar to working with a person. It's better to frame your conversation first, and then describe the specific details rather than sending everything in a single request that may be misinterpreted.
 
 ## Use prompt keywords
 
@@ -24,7 +24,7 @@ GitHub Copilot uses the following keywords to help you specify the context and i
 
 ### Chat participants
 
-GitHub Copilot Chat provides better responses when it understands the context that you're interested in and can apply the best resources. You can help GitHub Copilot Chat generate better responses by adding a Chat participants to your prompts. Chat participants are like experts in a specific field that provide better responses. Chat participants are specified using the `@` symbol.
+GitHub Copilot Chat provides better responses when it understands the context that you're interested in and can apply the best resources. You can help GitHub Copilot Chat generate better responses by adding a Chat participant to your prompts. Chat participants are like experts in a specific field that provide better responses. Chat participants are specified using the `@` symbol.
 
 Currently, Copilot Chat supports the following built-in chat participants:
 
@@ -68,7 +68,7 @@ Examples of built-in slash commands:
 - `/new`: Scaffold code for a new workspace. Only the chat prompt is used as context.
 - `/newNotebook`: Create a new Jupyter Notebook. Only the chat prompt is used as context.
 
-Examples using Chat participants combined with slash commands:
+Examples using chat participants combined with slash commands:
 
 - `@workspace /explain`: Generate an explanation of the full workspace.
 - `@workspace /fix` (or `/fix`): Propose a fix for the problems in the selected code.
@@ -100,20 +100,20 @@ Conceptually, both `@workspace` and `#codebase` enable you to ask questions abou
 
 About the `@workspace` keyword:
 
-- Chat participant, dedicated to answering questions about your codebase.
-- Takes control of the user prompt and uses the codebase to provide an answer.
-- Can't invoke other tools.
-- Can only be used in Ask mode.
-- Example: "@workspace how can I validate a date?"
+- The `@workspace` keyword is a chat participant that's dedicated to answering questions about your codebase.
+- The `@workspace` keyword takes control of the user prompt and uses the codebase to provide an answer.
+- The `@workspace` keyword can't invoke other tools.
+- The `@workspace` keyword can only be used when you're using the ask mode.
+- Example: "`@workspace how can I validate a date?`"
 
 About the `#codebase` keyword:
 
-- Tool that performs a codebase search based on the user prompt and adds the relevant code as context to the chat prompt.
-- The LLM remains in control and can combine it with other tools for editing scenarios.
-- Can be used in all chat modes (Ask, Edit, and Agent).
+- The `#codebase` keyword is a tool that performs a codebase search based on the user prompt and adds the relevant code as context to the chat prompt.
+- When you use the `#codebase` keyword, the language model remains in control and can combine `#codebase` with other tools for editing scenarios.
+- The `#codebase` keyword can be used in all chat modes (Ask, Edit, and Agent).
 - Examples: "`add a tooltip to this button, consistent with other button #codebase`", "`add unit tests and run them #codebase`"
 
-It's recommended to use `#codebase` in your chat prompts, as it provides more flexibility.
+GitHub recommends using `#codebase` in your chat prompts, as it provides more flexibility.
 
 ## Summary
 
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
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/5-generate-project-documentation-using-github-copilot.md b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/5-generate-project-documentation-using-github-copilot.md
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/7-exercise-analyze-document-code-github-copilot.md b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/7-exercise-analyze-document-code-github-copilot.md
diff --git a/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/9-summary.md b/learn-pr/wwl-azure/generate-documentation-using-github-copilot-tools/includes/9-summary.md
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
