Repo sync

content/copilot/concepts/context/mcp.md

@@ -45,6 +45,13 @@ Running the {% data variables.product.github %} MCP server locally requires a bi
 
 To learn how to set up and use the {% data variables.product.github %} MCP server, see [AUTOTITLE](/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server).
 
+## About the {% data variables.product.github %} MCP Registry
+
+The {% data variables.product.github %} MCP Registry is a curated list of MCP servers from partners and the community. You can use the registry to discover new MCP servers and find ones that meet your specific needs. See [the {% data variables.product.github %} MCP Registry](https://github.com/mcp).
+
+>[!NOTE]
+> The {% data variables.product.github %} MCP Registry is currently in {% data variables.release-phases.public_preview %} and subject to change.
+
 ## Availability
 
 There is currently broad support for local MCP servers in clients such as {% data variables.product.prodname_vscode %}, JetBrains IDEs, XCode, and others.

content/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp.md

@@ -35,6 +35,25 @@ For information on currently available MCP servers, see [the MCP servers reposit
 
 ## Configuring MCP servers in {% data variables.product.prodname_vscode %}
 
+MCP servers can be configured manually in a configuration file, or through the {% data variables.product.github %} MCP Registry. The {% data variables.product.github %} MCP Registry provides a curated list of MCP servers that you can easily add to your {% data variables.product.prodname_vscode %} instance.
+
+### Using the {% data variables.product.github %} MCP Registry
+
+>[!NOTE]
+> The {% data variables.product.github %} MCP Registry is in {% data variables.release-phases.public_preview %} and may change.
+
+Only MCP servers listed in the {% data variables.product.github %} MCP Registry can be added through the registry. Other servers can be configured manually. See [Configuring MCP servers manually](#configuring-mcp-servers-manually).
+
+1. Visit the [{% data variables.product.github %} MCP Registry](https://github.com/mcp).
+1. In the search bar, search for the MCP server you want to add, then click the MCP server in the list of matches.
+1. On the MCP server page, read the description for details on installation requirements and other important usage information. This may vary between servers.
+1. Click **Install server**, then select **Install in {% data variables.product.prodname_vscode_shortname %}**.
+1. {% data variables.product.prodname_vscode %} will open, on the server's Marketplace page. Click **Install** to add the MCP server to your {% data variables.product.prodname_vscode %} instance.
+1. If further configuration is required, follow the instructions on the MCP server page in the {% data variables.product.github %} MCP Registry.
+1. To check that the MCP server has been added, in the **agent mode** of {% data variables.copilot.copilot_chat_short %}, click the tools icon. A dropdown list will appear, showing all the MCP servers and associated tools that are currently available in your {% data variables.product.prodname_vscode %} instance.
+
+### Configuring MCP servers manually
+
 To configure MCP servers in {% data variables.product.prodname_vscode %}, you need to set up a configuration script that specifies the details of the MCP servers you want to use. You can configure MCP servers for either:
 
 {% data reusables.copilot.mcp.mcp-configuration-location %}

data/reusables/profile/copilot_settings.md

@@ -0,0 +1 @@
+1. In the top right corner of {% data variables.product.prodname_dotcom %}, click your profile picture, then click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %} settings**.

data/reusables/two_fa/sms-warning.md

@@ -1,4 +1,4 @@
 Before using this method, be sure that you can receive text messages. Carrier rates may apply.
 
 > [!WARNING]
-> We **strongly recommend** using a TOTP application for two-factor authentication instead of SMS, and security keys as backup methods instead of SMS. {% data variables.product.github %} doesn't support sending SMS messages to phones in every country. Before configuring authentication via text message, review the list of countries where {% data variables.product.github %} supports authentication via SMS. For more information, see [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/countries-where-sms-authentication-is-supported).
+> We **strongly recommend** using a TOTP application for two-factor authentication instead of SMS, and using security keys as backup methods instead of SMS. SMS is susceptible to interception, does not provide resistance against phishing attacks, has unreliable deliverability, and is not supported in all countries. Before configuring authentication via text message, review the list of countries where {% data variables.product.github %} supports authentication via SMS. For more information, see [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/countries-where-sms-authentication-is-supported).

src/audit-logs/data/fpt/organization.json

@@ -9313,7 +9313,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",

src/audit-logs/data/fpt/user.json

@@ -4083,7 +4083,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -8086,7 +8086,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/audit-logs/data/ghec/enterprise.json

@@ -12644,7 +12644,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",

src/audit-logs/data/ghec/organization.json

@@ -9313,7 +9313,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",

src/audit-logs/data/ghec/user.json

@@ -4083,7 +4083,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -8086,7 +8086,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/audit-logs/data/ghes-3.14/enterprise.json

@@ -8793,7 +8793,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -15569,7 +15569,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/audit-logs/data/ghes-3.14/organization.json

@@ -8456,7 +8456,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",

src/audit-logs/data/ghes-3.14/user.json

@@ -3757,7 +3757,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -7644,7 +7644,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/audit-logs/data/ghes-3.15/enterprise.json

@@ -8876,7 +8876,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -15768,7 +15768,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/audit-logs/data/ghes-3.15/organization.json

@@ -8565,7 +8565,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",

src/audit-logs/data/ghes-3.15/user.json

@@ -3840,7 +3840,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -7843,7 +7843,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/audit-logs/data/ghes-3.16/enterprise.json

@@ -9231,7 +9231,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -16482,7 +16482,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/audit-logs/data/ghes-3.16/organization.json

@@ -8907,7 +8907,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",

src/audit-logs/data/ghes-3.16/user.json

@@ -3994,7 +3994,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -7997,7 +7997,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/audit-logs/data/ghes-3.17/enterprise.json

@@ -9609,7 +9609,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -16929,7 +16929,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/audit-logs/data/ghes-3.17/organization.json

@@ -9097,7 +9097,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",

src/audit-logs/data/ghes-3.17/user.json

@@ -4057,7 +4057,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -8060,7 +8060,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/audit-logs/data/ghes-3.18/enterprise.json

@@ -9658,7 +9658,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -17032,7 +17032,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/audit-logs/data/ghes-3.18/organization.json

@@ -9288,7 +9288,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",

src/audit-logs/data/ghes-3.18/user.json

@@ -4083,7 +4083,7 @@
       "actor",
       "operation_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "project.access",
@@ -8086,7 +8086,7 @@
       "token_scopes",
       "programmatic_access_type"
     ],
-    "docs_reference_titles": "Personalizing your profile"
+    "docs_reference_titles": "Personalize your profile"
   },
   {
     "action": "user.suspend",

src/content-linter/lib/default-markdownlint-options.ts

@@ -0,0 +1,5 @@
+import type { Configuration } from 'markdownlint'
+
+export const defaultConfig: Configuration = {
+  default: false,
+}

src/content-linter/lib/helpers/get-rules.ts

@@ -0,0 +1,12 @@
+import { gitHubDocsMarkdownlint } from '@/content-linter/lib/linting-rules/index'
+import { baseConfig } from '@/content-linter/style/base'
+import { customConfig } from '@/content-linter/style/github-docs'
+import type { Rule } from '@/content-linter/types'
+
+// Import markdownlint rules - external library without TypeScript declarations
+// @ts-ignore - markdownlint doesn't provide TypeScript declarations
+import markdownlintRules from '../../../../node_modules/markdownlint/lib/rules'
+
+export const customRules: Rule[] = gitHubDocsMarkdownlint.rules
+export const allRules: any[] = [...markdownlintRules, ...gitHubDocsMarkdownlint.rules]
+export const allConfig: Record<string, any> = { ...baseConfig, ...customConfig }