Merge branch 'main' into patch-1

Author: Sharra-writes

config/moda/secrets/production/secrets.yml

@@ -1,8 +1,66 @@
----
 secrets:
   COOKIE_SECRET:
     kind: latest_at_deployment_start
-    key: COOKIE_SECRET
     type: salt
     owner: '@github/docs-engineering'
     externally_usable: true
+  CSE_COPILOT_ENDPOINT:
+    kind: latest_at_deployment_start
+    type: salt
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  CSE_COPILOT_SECRET:
+    kind: latest_at_deployment_start
+    type: salt
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  DOCS_BOT_PAT_BASE:
+    kind: latest_at_deployment_start
+    type: github_pat
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  DOCS_BOT_PAT_COPILOT:
+    kind: latest_at_deployment_start
+    type: github_pat
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  DOCS_BOT_PAT_REPO_SYNC:
+    kind: latest_at_deployment_start
+    type: github_pat
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  ELASTICSEARCH_URL:
+    kind: latest_at_deployment_start
+    type: elasticsearch
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  FASTLY_API_TOKEN:
+    kind: latest_at_deployment_start
+    type: fastly
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  FASTLY_SERVICE_ID:
+    kind: latest_at_deployment_start
+    type: fastly
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  FASTLY_TOKEN:
+    kind: latest_at_deployment_start
+    type: fastly
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  HAYSTACK_URL:
+    kind: latest_at_deployment_start
+    type: failbot
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  HYDRO_ENDPOINT:
+    kind: latest_at_deployment_start
+    type: hydro_api_key
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  HYDRO_SECRET:
+    kind: latest_at_deployment_start
+    type: hydro_api_key
+    owner: '@github/docs-engineering'
+    externally_usable: true

content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-the-monitor-dashboards.md

@@ -61,6 +61,8 @@ On this more detailed dashboard you can get further insights into all aspects of
 
 Starting with {% data variables.product.prodname_ghe_server %} 3.18, you can create custom Grafana dashboards and alerts directly inside the {% data variables.enterprise.management_console %}. These custom dashboards and alerts will persist over upgrades, making it easier to maintain your monitoring configuration.
 
+> [!IMPORTANT] Pre-built dashboards can be opened and edited for inspection, but changes cannot be saved. Create a copy of a dashboard to apply and retain any customizations.
+
 You can use OpenTelemetry and collectd metrics concurrently for external monitoring. During the {% data variables.release-phases.public_preview %}, collectd remains enabled and cannot be disabled.
 
 {% else %}

content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/configuring-opentelemetry-for-your-instance.md

@@ -170,4 +170,5 @@ sudo journalctl -u victoriametrics -f
 ## Next steps
 
 * To enable advanced monitoring dashboards, see [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/advanced-dashboards)
+* Exploring OpenTelemetry metrics, see [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/using-grafana-to-analyze-opentelemetry-metrics).
 * To set up external monitoring, see [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/setting-up-external-monitoring-with-opentelemetry).

content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/index.md

@@ -1,6 +1,6 @@
 ---
 title: OpenTelemetry metrics
-intro: 'You can configure monitoring and alerting using OpenTelemetry so that you''re aware of potential issues before they negatively impact application performance or availability.'
+intro: You can configure monitoring and alerting using OpenTelemetry so that you're aware of potential issues before they negatively impact application performance or availability.
 versions:
   feature: ghes-opentelemetry
 topics:
@@ -9,6 +9,7 @@ children:
   - /about-opentelemetry-metrics
   - /configuring-opentelemetry-for-your-instance
   - /advanced-dashboards
+  - /using-grafana-to-analyze-opentelemetry-metrics
   - /setting-up-external-monitoring-with-opentelemetry
 shortTitle: OpenTelemetry metrics
 ---

content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/using-grafana-to-analyze-opentelemetry-metrics.md

@@ -0,0 +1,75 @@
+---
+title: Using Grafana to analyze OpenTelemetry metrics
+intro: Monitor the health and performance of your instance using dashboards and metrics provided by the OpenTelemetry metrics stack.
+versions:
+  feature: ghes-opentelemetry
+topics:
+  - Enterprise
+  - Fundamentals
+  - Infrastructure
+  - Monitoring
+  - Performance
+type: how_to
+shortTitle: Using Grafana to analyze metrics
+contentType: other
+---
+
+## Prerequisites
+
+OpenTelemetry metrics must be enabled on the instance. For configuration instructions, see [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/configuring-opentelemetry-for-your-instance).
+
+## Navigating to the monitor dashboards
+
+{% data reusables.enterprise_site_admin_settings.access-settings %}
+{% data reusables.enterprise_site_admin_settings.management-console %}
+{% data reusables.enterprise_management_console.type-management-console-password %}
+1. Click the **Monitor** tab.
+
+
+### Metric labels
+
+The OpenTelemetry stack exporters automatically attach labels to metrics. Common labels are:
+
+* `job` — the name of the exporter that produced the metric
+* `instance` — the instance name from which the metric originated
+
+For some exporters (like `node_exporter` or `haproxy_exporter`), open-source documentation may be available by searching for the `job` label value.
+
+Label availability varies by exporter and metric. Some GitHub application-level metrics may provide fewer labels than infrastructure/exporter metrics, and labels are subject to change from version to version.
+
+
+## Inspecting panel queries
+
+> [!IMPORTANT] Pre-built dashboards can be opened and edited for inspection, but changes cannot be saved. Create a copy of a dashboard to apply and retain any customizations.
+
+To understand which metrics and queries power a given panel, use the graph panel menu *(3 vertical dots)* when viewing a Grafana dashboard:
+
+* **Edit**: Opens the panel editor. This is the most direct way to review and adjust the queries that power the visualization.  
+* **Explore**: Opens Grafana Explore with the panel’s queries pre-populated, allowing interactive analysis.  
+* **Metrics Drilldown**: Opens a side panel for discovering related metrics and breaking down the metric by label values.
+
+## Exploring metrics in Grafana
+
+Grafana provides multiple ways to discover and analyze the metrics available on your instance.
+
+### Grafana Drilldown
+
+Grafana Drilldown provides a guided workflow to discover metrics by filtering on metric prefixes, labels, and label values. After selecting a metric, Grafana can break down the series by available label values. For example, `haproxy_backend_response_errors_total` can be grouped by proxy/back-end label values.
+
+### Grafana Explore
+
+Grafana Explore enables interactive analysis using PromQL (Prometheus Query Language), including a query builder that can help users discover available metrics and labels.
+
+Tips for working in Grafana Explore:
+
+* Use **Code mode's Metric browser** to discover metrics and labels. Selecting labels and label values can reveal associated metrics, and selecting a metric can reveal associated labels and label values.
+* After selecting a metric, switch to **Builder mode** for suggestions to refine the query.
+* Access additional operations via the **+ Operations** button.
+* Customize legend labels in the **Options** panel using the **Legend** setting, for example `{{<label_name>}}`. By default, Grafana assigns legend labels based on unique label sets.
+
+## Further reading
+
+* [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/advanced-dashboards)
+* [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-the-monitor-dashboards#creating-new-dashboards)
+* [Get Started with Explore](https://grafana.com/docs/grafana/latest/visualizations/explore/get-started-with-explore/) in the Grafana documentation 
+* [Promql - Querying Basics](https://prometheus.io/docs/prometheus/latest/querying/basics/) in the Prometheus documentation

content/code-security/tutorials/trialing-github-advanced-security/explore-trial-code-scanning.md

@@ -84,11 +84,11 @@ Most enterprises put automatic checks in place to block the use of dependencies
 
 This allows you to update the configuration in a single location, but use the workflow in many repositories. You may want to use this central repository to maintain other workflows. For more information, see [AUTOTITLE](/actions/sharing-automations/reusing-workflows).
 
-### {% data variables.product.prodname_copilot_short %} review
+### {% data variables.copilot.copilot_code-review_short %}
 
 > [!NOTE]
 >
-> * If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you will only be able to participate in the {% data variables.release-phases.public_preview %} on the {% data variables.product.github %} website if an owner of your organization or enterprise has enabled **Copilot in GitHub.com > Opt in to preview features** in the **{% data variables.product.prodname_copilot %} policies** page of the organization or enterprise settings. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) and [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-in-githubcom){% ifversion fpt or ghes %} in the {% data variables.product.prodname_ghe_cloud %} documentation{% endif %}.
+> * If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you will only be able to participate in the {% data variables.release-phases.public_preview %} on the {% data variables.product.github %} website if an owner of your organization or enterprise has enabled {% data variables.copilot.copilot_code-review_short %}. See [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies#opting-in-to-previews-or-feedback) and [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies){% ifversion fpt or ghes %} in the {% data variables.product.prodname_ghe_cloud %} documentation{% endif %}.
 
 By default, users request a review from {% data variables.product.prodname_copilot_short %} in the same way as they do from human reviewers. However, you can update or create an organization-level branch ruleset to automatically add {% data variables.product.prodname_copilot_short %} as a reviewer to all pull requests made to selected branches in all or selected repositories. See [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/agents/copilot-code-review/automatic-code-review){% ifversion fpt or ghes %} in the {% data variables.product.prodname_ghe_cloud %} documentation{% endif %}.
 

content/copilot/concepts/agents/enterprise-management.md

@@ -11,21 +11,23 @@ category:
   - Learn about Copilot
 ---
 
-{% data reusables.enterprise-accounts.ai-controls-preview-note %}
-
 ## Overview
 
-The AI Controls view provides a centralized platform where you can manage and monitor agents across your enterprise. From this agent control plane, you can:
+The AI Controls view provides a centralized platform where you can manage and monitor AI policies and agents across your enterprise. From the "Agents" page, you can:
 * Manage the enterprise-level availability of agents like {% data variables.copilot.copilot_coding_agent %}, {% data variables.copilot.copilot_code-review_short %}, and {% data variables.copilot.copilot_custom_agents %}
 * Control who can manage your enterprise-level {% data variables.copilot.custom_agents_short %}
-* View a list of agent sessions in your enterprise over the last 24 hours
+* View and filter a list of agent sessions in your enterprise over the last 24 hours
 * Find a detailed record of agentic audit log events
 
 ## {% data variables.copilot.copilot_custom_agents %}
 
 {% data variables.copilot.copilot_custom_agents %} are specialized versions of {% data variables.copilot.copilot_coding_agent %} that you can configure with tailored prompts, tools, and context, making them excel at specific tasks. {% data variables.copilot.custom_agents_caps_short %} can be defined and managed at the enterprise level for greater control and compliance, or at the organization and repository levels to allow teams the flexibility to build for their specific needs.
 
-Before you start configuring agentic settings for your enterprise, you should have a strong understanding of {% data variables.copilot.custom_agents_short %}. To learn more, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents).
+You can manage your enterprise-level {% data variables.copilot.custom_agents_short %}:
+* From the AI Controls view
+* Using the REST API. See [AUTOTITLE](/rest/copilot/copilot-custom-agents).
+
+For more detailed information on {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents).
 
 ## Agent sessions
 
@@ -39,3 +41,7 @@ For billing information on agent sessions, see [AUTOTITLE](/billing/concepts/pro
 ## Next steps
 
 To get started with {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents).
+
+## Further reading
+
+* [AUTOTITLE](/copilot/concepts/agents/about-third-party-agents)

content/copilot/concepts/context/mcp.md

@@ -99,6 +99,7 @@ The {% data variables.product.github %} MCP Registry is a curated list of MCP se
 
 ## Next steps
 
+* [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)
 * [AUTOTITLE](/copilot/how-tos/context/model-context-protocol/extending-copilot-chat-with-mcp)
 * [AUTOTITLE](/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server)
 * [AUTOTITLE](/copilot/tutorials/enhancing-copilot-agent-mode-with-mcp)

content/copilot/concepts/prompting/response-customization.md

@@ -93,6 +93,8 @@ Here are some common use cases and examples for each type of custom instructions
   * Preferred language for a company which exclusively speaks a single language: `Always respond in Portuguese.`
   * Organization-wide preferences: `Do not generate code blocks in responses.`
 
+{% data reusables.copilot.code-review.custom-instructions-limit %}
+
 {% data reusables.copilot.custom-instructions-effective %}
 
 ## Next steps

content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-code-review.md

@@ -11,7 +11,7 @@ shortTitle: 'Manage {% data variables.copilot.copilot_code-review_short %}'
 redirect_from:
   - /copilot/how-tos/administer-copilot/manage-for-enterprise/manage-copilot-code-review
 contentType: how-tos
-category: 
+category:
   - Manage Copilot for a team
 ---
 
@@ -28,7 +28,6 @@ You can allow your members to use {% data variables.copilot.copilot_code-review_
 > [!NOTE]
 >
 > {% data reusables.copilot.code-review.preview-note %}
-> * To participate in the {% data variables.release-phases.public_preview %}, you must first enable **{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %} > Opt in to preview features** from the "{% data variables.product.prodname_copilot_short %}" page of your enterprise's AI Controls.
 
 {% data reusables.enterprise-accounts.policy-enablement-next-steps %}