Merge pull request #42737 from github/repo-sync

Repo sync

Author: docs-bot

content/code-security/how-tos/manage-security-alerts/manage-secret-scanning-alerts/monitoring-alerts.md

@@ -1,6 +1,6 @@
 ---
 title: Monitoring alerts from secret scanning
-intro: Learn how and when {% data variables.product.github %} will notify you about a secret scanning alert.
+intro: You can configure how  {% data variables.product.prodname_secret_scanning %} notifies you about {% data variables.product.prodname_secret_scanning %} alerts, and audit how your team responds to these alerts.
 permissions: '{% data reusables.permissions.secret-scanning-alerts %}'
 versions:
   fpt: '*'
@@ -18,6 +18,10 @@ redirect_from:
   - /code-security/secret-scanning/managing-alerts-from-secret-scanning/monitoring-alerts
 ---
 
+When {% data variables.product.prodname_secret_scanning %} detects a potential secret leak in your repository, staying informed about these alerts is crucial for maintaining your code's security. {% data variables.product.github %} provides multiple notification channels to ensure you and your team are promptly alerted when secrets are found. You can customize how and when you receive these notifications based on your role and preferences.
+
+You can also audit responses to {% data variables.product.prodname_secret_scanning %} alerts to track how your team manages security issues and maintain compliance with your organization's security policies.
+
 ## Configuring notifications for {% data variables.secret-scanning.alerts %}
 
 In addition to displaying an alert in the **Security** tab of the repository, {% data variables.product.github %} can also send email notifications for alerts. These notifications are different for incremental scans and historical scans.

content/copilot/how-tos/copilot-cli/cli-best-practices.md

@@ -199,7 +199,7 @@ For best results on complex tasks:
 
 **Session storage location:**
 
-```copilot
+```text
 ~/.copilot/session-state/{session-id}/
 ├── events.jsonl      # Full session history
 ├── workspace.yaml    # Metadata
@@ -213,17 +213,38 @@ For best results on complex tasks:
 
 ### Session management commands
 
-```bash
-# View session info
+To view information about the current CLI session, enter:
+
+```copilot
 /session
+```
+
+To view a list of any session checkpoints, enter:
 
-# View checkpoint history
+```copilot
 /session checkpoints
+```
+
+> [!NOTE]
+> A checkpoint is created when session context is compacted, and allows you to view the summary context that {% data variables.product.prodname_copilot_short %} created.
+
+To view the details of a specific checkpoint, enter:
 
-# View files in session
+```copilot
+/session checkpoints NUMBER
+```
+
+where NUMBER specifies the checkpoint you want to display.
+
+To view any temporary files that have been created during the current session—for example, artifacts created by {% data variables.product.prodname_copilot_short %} that shouldn't be saved to the repository—enter:
+
+```copilot
 /session files
+```
+
+To view the current plan (if {% data variables.product.prodname_copilot_short %} has generated one), enter:
 
-# View current plan
+```copilot
 /session plan
 ```
 
@@ -317,7 +338,6 @@ Pair with {% data variables.copilot.copilot_cli_short %} to develop tests.
 * `/plan Migrate all class components to functional components with hooks`
 
   Then answer the questions {% data variables.product.prodname_copilot_short %} asks. Review the plan it creates, and ask {% data variables.product.prodname_copilot_short %} to make changes if necessary. When you are happy with the plan you can prompt:
-  
   `Implement this plan`
 
 ## 6. Advanced patterns
@@ -352,13 +372,13 @@ copilot
 
 **View and manage allowed directories:**
 
-```bash
+```copilot
 /list-dirs
 ```
 
 **Example workflow: coordinated API changes**
 
-```bash
+```copilot
 I need to update the user authentication API. The changes span:
 
 - @/Users/me/projects/api-gateway (routing changes)
@@ -379,7 +399,7 @@ This multi-repository capability enables:
 
 {% data variables.product.prodname_copilot_short %} can work with visual references. Simply **drag and drop** images directly into the CLI input, or reference image files:
 
-```bash
+```copilot
 Implement this design: @mockup.png
 Match the layout and spacing exactly
 ```
@@ -388,7 +408,7 @@ Match the layout and spacing exactly
 
 For large-scale changes:
 
-```bash
+```copilot
 Run the linter and write all errors to `migration-checklist.md` as a checklist.
 Then fix each issue one by one, checking them off as you go.
 ```
@@ -424,16 +444,35 @@ Track metrics like:
 * Code review feedback cycles
 * Test coverage improvements
 
-### Getting help
+## Getting help
+
+From the command line, you can display help by using the command: `copilot -h`.
+
+For help on various topics enter:
 
 ```bash
-# In-CLI help
+copilot help TOPIC
+```
+
+where `TOPIC` can be one of: `config`, `commands`, `environment`, `logging`, or `permissions`.
+
+### Within the CLI
+
+For help within the CLI, enter:
+
+```copilot
 /help
+```
 
-# View usage statistics
+To view usage statistics, enter:
+
+```copilot
 /usage
+```
 
-# Submit feedback
+To submit private feedback to {% data variables.product.github %} about {% data variables.copilot.copilot_cli_short %}, raise a bug report, or submit a feature request, enter:
+
+```copilot
 /feedback
 ```
 

content/copilot/how-tos/use-copilot-agents/coding-agent/index.md

@@ -9,6 +9,7 @@ topics:
 children:
   - /create-a-pr
   - /make-changes-to-an-existing-pr
+  - /provide-visual-inputs
   - /track-copilot-sessions
   - /review-copilot-prs
   - /create-custom-agents

content/copilot/how-tos/use-copilot-agents/coding-agent/provide-visual-inputs.md

@@ -0,0 +1,49 @@
+---
+title: Provide visual inputs to GitHub Copilot
+shortTitle: Provide visual inputs
+intro: 'You can attach images to issues or {% data variables.copilot.copilot_chat_short %} prompts to help {% data variables.product.prodname_copilot_short %} understand your task.'
+product: '{% data reusables.gated-features.copilot-coding-agent %}<br><a href="https://github.com/features/copilot/plans?ref_product=copilot&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Sign up for {% data variables.product.prodname_copilot_short %}</span> {% octicon "link-external" height:16 %}</a>'
+versions:
+  feature: copilot
+topics:
+  - Copilot
+contentType: how-tos
+category: 
+  - Author and optimize with Copilot
+---
+
+> [!NOTE]
+> For an overview of {% data variables.copilot.copilot_coding_agent %}, see [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent).
+
+## Introduction
+
+{% data variables.copilot.copilot_coding_agent_short_cap_c %} can process images, such as a photo or screenshot of a sketch or design, as part of your task description. This is useful when you want to show {% data variables.product.prodname_copilot_short %} what you're trying to achieve visually, for example, when updating a UI or implementing a design.
+
+You can provide images to {% data variables.product.prodname_copilot_short %} in two ways:
+
+* **In an issue**: Add an image to the issue body, with a description of the task you want {% data variables.product.prodname_copilot_short %} to complete, then assign the issue to {% data variables.product.prodname_copilot_short %}.
+* **In {% data variables.copilot.copilot_chat_short %}**: Attach images to your prompt when you ask {% data variables.product.prodname_copilot_short %} to create a pull request.
+
+## Attaching images to an issue
+
+1. Navigate to the repository where you want to create the issue.
+1. Create a new issue or open an existing issue.
+1. In the issue body, drag and drop your image.
+1. Add a clear description of what you want {% data variables.product.prodname_copilot_short %} to do with the image. For example, "Let's update the login form to match this mockup".
+1. Assign the issue to {% data variables.product.prodname_copilot_short %}. For detailed instructions, see [Assign an issue to {% data variables.product.prodname_copilot_short %} on {% data variables.product.prodname_dotcom_the_website %}](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr#assigning-an-issue-to-copilot-on-githubcom).
+
+{% data variables.product.prodname_copilot_short %} will analyze the image along with your description when working on the task.
+
+## Attaching images in {% data variables.copilot.copilot_chat_short %}
+
+1. Open {% data variables.copilot.copilot_chat_short %}.
+1. Attach your image to the chat prompt, and use `/task` to describe what you want {% data variables.product.prodname_copilot_short %} to do. For example, "Update the notification badge to match this mockup". 
+
+   For detailed instructions, see [Asking {% data variables.product.prodname_copilot_short %} to create a pull request from {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_dotcom_the_website %}](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr#asking-copilot-to-create-a-pull-request-from-copilot-chat-in-githubcom).
+1. {% data variables.product.prodname_copilot_short %} will create a pull request using the image as context for the task.
+
+## Further reading
+
+* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr)
+* [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices)
+* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/review-copilot-prs)