Merge branch 'main' into main

Author: djbrown

.github/workflows/test.yml

@@ -58,7 +58,6 @@ jobs:
           - graphql
           - landings
           - languages
-          - learning-track
           # - links
           - observability
           # - open-source

CHANGELOG.md

@@ -1,5 +1,41 @@
 # Docs changelog
 
+**9 April 2026**
+
+We have added documentation for the code security risk assessment (CSRA), a free self-serve tool that helps organization admins and security managers understand their organization's exposure to code vulnerabilities.
+New content includes:
+
+* [Code security risk assessment](https://docs.github.com/en/code-security/concepts/code-scanning/code-security-risk-assessment): What the CSRA is, who can run it, what it scans, and how it relates to the secret risk assessment.
+* [Running a code security risk assessment](https://docs.github.com/en/code-security/how-tos/secure-at-scale/configure-organization-security/configure-specific-tools/assess-your-vulnerability-risk): How to generate and rerun a CSRA report.
+* [Interpreting code security risk assessment results](https://docs.github.com/en/code-security/tutorials/secure-your-organization/interpreting-code-security-risk-assessment-results): How to read the results dashboard, understand vulnerability and rule breakdowns, and enable Code Security directly from the assessment.
+
+<hr>
+
+**3 April 2026**
+
+We've published documentation for the GitHub Copilot SDK, now available in public preview. These docs were migrated from the `github/copilot-sdk` repo and cover getting started, setup, authentication, usage patterns, hooks, observability, integrations, and troubleshooting.
+
+See [GitHub Copilot SDK documentation](https://docs.github.com/en/copilot/how-tos/copilot-sdk).
+
+<hr>
+
+**2 April 2026**
+
+We've expanded the documentation for custom agents in Copilot CLI, adding information about the built-in agents.
+
+[About custom agents](https://docs.github.com/en/copilot/concepts/agents/copilot-cli/about-custom-agents#built-in-agents)
+
+<hr>
+
+**31 March 2026**
+
+The documentation for Copilot CLI now includes a new reference article about the `~/.copilot` directory, and information on how a Copilot skill can run a script:
+
+* [GitHub Copilot CLI configuration directory](https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-config-dir-reference)
+* [Creating agent skills for GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/create-skills#enabling-a-skill-to-run-a-script)
+
+<hr>
+
 **27 March 2026**
 
 We've introduced a new discovery landing page design for all the top-level doc sets on docs.github.com. The landing pages highlight recommended articles and give users the ability to filter articles by category with a drop down menu. Every article across the site now includes category metadata, making it easier to browse doc sets without relying solely on search. This replaces the previous product-landing layout across 35 doc sets.
@@ -77,7 +113,7 @@ We've added an article about the new `/research` slash command in Copilot CLI:
 
 **27 February 2026**
 
-We've extended the reference information for Copilot CLI, adding much more detail. See [GitHub Copilot CLI command reference](https://docs.github.com/copilot/reference/cli-command-reference#custom-agents-reference).
+We've extended the reference information for Copilot CLI, adding much more detail. See [GitHub Copilot CLI command reference](https://docs.github.com/copilot/reference/copilot-cli-reference/cli-command-reference#custom-agents-reference).
 
 <hr>
 
@@ -89,7 +125,7 @@ We've added many new articles to coincide with the [general availability release
 * [New conceptual articles](https://docs.github.com/copilot/concepts/agents/copilot-cli) explaining plugins, autopilot mode, the `/fleet` slash command, and a comparison of CLI features.
 * New how-to articles on [setting up](https://docs.github.com/copilot/how-tos/copilot-cli/set-up-copilot-cli) and [customizing](https://docs.github.com/copilot/how-tos/copilot-cli/customize-copilot) the CLI.
 * An article on [administering Copilot CLI for your enterprise](https://docs.github.com/copilot/how-tos/copilot-cli/administer-copilot-cli-for-your-enterprise).
-* More reference information about [commands](https://docs.github.com/copilot/reference/cli-command-reference) and [plugins](https://docs.github.com/copilot/reference/cli-plugin-reference).
+* More reference information about [commands](https://docs.github.com/copilot/reference/copilot-cli-reference/cli-command-reference) and [plugins](https://docs.github.com/copilot/reference/copilot-cli-reference/cli-plugin-reference).
 
 <hr>
 
@@ -115,11 +151,11 @@ We've published a new tutorial on [using GitHub Copilot coding agent to improve
 
 **20 January 2026**
 
-We published the first iteration of the [GitHub Copilot feature matrix](https://docs.github.com/copilot/reference/copilot-feature-matrix) to provide customers with the latest information about which Copilot features are available by which IDE/version. 
+We published the first iteration of the [GitHub Copilot feature matrix](https://docs.github.com/copilot/reference/copilot-feature-matrix) to provide customers with the latest information about which Copilot features are available by which IDE/version.
 
 Historically, keeping Copilot feature and IDE availability up to date has required manual coordination with the Docs team, which does not scale well with the increasing number of features. The goal of this document and its process is to enable product owners to directly maintain the Copilot feature and IDE availability information as part of their normal release workflow. The feature matrix provides a single, easy to update source of truth.
 
-The feature matrix is in public preview so that customers have time to gather and submit feedback to us. 
+The feature matrix is in public preview so that customers have time to gather and submit feedback to us.
 
 <hr>
 
@@ -196,15 +232,15 @@ You can also now add files to a Copilot Space directly from the code view on Git
 
 **25 November 2025**
 
-We've added details of files that are excluded from Copilot code reviews. 
+We've added details of files that are excluded from Copilot code reviews.
 
 See [About GitHub Copilot code review](https://docs.github.com/copilot/concepts/agents/code-review#excluded-files).
 
 <hr>
 
 **24 November 2025**
 
-We've added a new tutorial on burning down technical debt in a project: 
+We've added a new tutorial on burning down technical debt in a project:
 
 [Using GitHub Copilot to reduce technical debt](https://docs.github.com/copilot/tutorials/reduce-technical-debt)
 
@@ -371,17 +407,17 @@ We’ve updated the Spark documentation to support the launch for Copilot Enterp
 
 **29 September 2025**
 
-Claude Sonnet 4.5 has been released as a Public Preview. At the time of launch, it will be available on the following platforms: 
+Claude Sonnet 4.5 has been released as a Public Preview. At the time of launch, it will be available on the following platforms:
 
-- **Copilot Chat** 
+- **Copilot Chat**
   - Released for GitHub.com, VS Code, GitHub Mobile
   - With: Copilot Pro, Pro+, Business, and Enterprise
 - **Copilot Coding Agent**
-  - With: Copilot Pro, and Copilot Pro+ 
+  - With: Copilot Pro, and Copilot Pro+
 - **Copilot CLI**
   - With: Copilot Pro, Pro+, Business, and Enterprise
 
-The following articles have been updated: 
+The following articles have been updated:
 
 - [About GitHub Copilot coding agent](https://docs.github.com/copilot/concepts/agents/coding-agent/about-coding-agent)
 - [Supported AI models in GitHub Copilot](https://docs.github.com/copilot/reference/ai-models/supported-models)
@@ -416,9 +452,9 @@ See:
 
 **25 September 2025**
 
-We've updated the documentation for the GA release of [Copilot Spaces](https://github.com/copilot/spaces). Spaces allow you to organize and centralize content and resources in order to ground Copilot Chat's responses in that context and share knowledge across teams. You can now also access Copilot Spaces in your IDE via the GitHub MCP server. 
+We've updated the documentation for the GA release of [Copilot Spaces](https://github.com/copilot/spaces). Spaces allow you to organize and centralize content and resources in order to ground Copilot Chat's responses in that context and share knowledge across teams. You can now also access Copilot Spaces in your IDE via the GitHub MCP server.
 
-See the updated docs: 
+See the updated docs:
 * [About organizing and sharing context with GitHub Copilot Spaces](https://docs.github.com/copilot/concepts/context/spaces)
 * [Creating GitHub Copilot Spaces](https://docs.github.com/copilot/how-tos/provide-context/use-copilot-spaces/create-copilot-spaces)
 * [Using GitHub Copilot Spaces](https://docs.github.com/copilot/how-tos/provide-context/use-copilot-spaces/use-copilot-spaces)
@@ -427,15 +463,15 @@ See the updated docs:
 
 **24 September 2025**
 
-Until now, assigning Copilot coding agent to an issue was limited to the same repository as the issue. 
+Until now, assigning Copilot coding agent to an issue was limited to the same repository as the issue.
+
+You can now:
 
-You can now: 
+* Assign Copilot coding agent to work in a different repository, supporting workflows where issues and code files are managed separately.
+* Provide additional instructions to tailor the agent's output to your requirements.
+* Choose the base branch for the agent to use.
 
-* Assign Copilot coding agent to work in a different repository, supporting workflows where issues and code files are managed separately. 
-* Provide additional instructions to tailor the agent's output to your requirements. 
-* Choose the base branch for the agent to use. 
- 
-These changes provide a more flexible, transparent, and user-friendly experience for managing automated coding tasks with Copilot coding agent. 
+These changes provide a more flexible, transparent, and user-friendly experience for managing automated coding tasks with Copilot coding agent.
 
 See the updated docs: [Using GitHub Copilot to work on an issue](https://docs.github.com/copilot/how-tos/use-copilot-agents/coding-agent/assign-copilot-to-an-issue#assigning-an-issue-to-copilot).
 
@@ -462,17 +498,17 @@ See [About the GitHub MCP Registry](https://docs.github.com/copilot/concepts/con
 
 **17 September 2025**
 
-We've added documentation for expanded features for reusing workflow configurations in GitHub Actions. 
+We've added documentation for expanded features for reusing workflow configurations in GitHub Actions.
 
-You can now use YAML anchors and aliases to reuse pieces of content in a workflow. See [YAML anchors and aliases](https://docs.github.com/actions/concepts/workflows-and-actions/reusing-workflow-configurations#yaml-anchors-and-aliases). 
+You can now use YAML anchors and aliases to reuse pieces of content in a workflow. See [YAML anchors and aliases](https://docs.github.com/actions/concepts/workflows-and-actions/reusing-workflow-configurations#yaml-anchors-and-aliases).
 
 To keep the content focused on users' job-to-be-done, we simplified the procedures for [creating workflow templates for your organization](https://docs.github.com/actions/how-tos/reuse-automations/create-workflow-templates). In addition, we updated reference documentation for workflow templates with details on permissions, repository visibility rules, rules for the metadata file, and examples. See [Workflow templates](https://docs.github.com/actions/reference/workflows-and-actions/reusing-workflow-configurations#workflow-templates).
 
 <hr>
 
 **17 September 2025**
 
-You can now publish your Spark app as "read-only." 
+You can now publish your Spark app as "read-only."
 
 By default, data stored in Spark is shared across all users of the app. You can choose to publish your app as "read-only" if you want to showcase your app to others, but you don't want others to be able to edit or delete any stored data.
 
@@ -585,7 +621,7 @@ See [Working with push protection and the GitHub MCP server](https://docs.github
 
 **12 August 2025**
 
-OpenAI GPT-5 is now available in public preview for GitHub Copilot. GPT-5 is slowly rolling out to all paid Copilot plans and you will be able to access the model in GitHub Copilot Chat on github.com and Visual Studio Code (Agent, Ask, and Edit modes). 
+OpenAI GPT-5 is now available in public preview for GitHub Copilot. GPT-5 is slowly rolling out to all paid Copilot plans and you will be able to access the model in GitHub Copilot Chat on github.com and Visual Studio Code (Agent, Ask, and Edit modes).
 
 See [Supported AI models in Copilot](https://docs.github.com/copilot/reference/ai-models/supported-models).
 
@@ -607,7 +643,7 @@ We have added a tutorial for using Copilot to create Mermaid diagrams at [Creati
 
 **4 August 2025**
 
-To address common pain points that developers face when remediating a leaked secret, we created a new article, "[Remediating a leaked secret](https://docs.github.com/code-security/secret-scanning/working-with-secret-scanning-and-push-protection/remediating-a-leaked-secret)". 
+To address common pain points that developers face when remediating a leaked secret, we created a new article, "[Remediating a leaked secret](https://docs.github.com/code-security/secret-scanning/working-with-secret-scanning-and-push-protection/remediating-a-leaked-secret)".
 
 The new guide incorporates cross-platform GitHub tools, as well as opinionated guidance from GitHub's secret scanning team, to walk the developer through a thorough remediation process.