Merge pull request #52692 from dotnet/main

Merge main into live

Author: gewarren

.github/copilot-instructions.md

@@ -29,12 +29,18 @@ Unless otherwise specified, all .NET content refers to modern .NET (not .NET Fra
 Use cross-references: `<xref:api-doc-ID>`.
 
 To find API doc IDs:
+
 1. Check XML files in https://github.com/dotnet/dotnet-api-docs.
 2. For types: `Value` attribute of `<TypeSignature>` where `Language="DocId"` (omit first 2 characters).
 3. For members: `Value` attribute of `<MemberSignature>` where `Language="DocId"` (omit first 2 characters).
 
 If unsure, use API browser: `https://learn.microsoft.com/api/apibrowser/dotnet/search?api-version=0.2&locale=en-us&search={API_NAME}&$skip=0&$top=5` and then use the `url` value from the results as a manual link.
 
+**Encoding**:
+
+1. Encode `#` as `%23` in API doc IDs. For example, `System.String.#ctor` becomes `System.String.%23ctor`.
+2. **DO NOT** encode `*` or \` (backtick) characters as `%2A` or `%60` respectively.
+
 ## Code Snippets
 
 For snippets >6 lines:

.github/prompts/error-consolidation.md

@@ -12,8 +12,8 @@ Overall steps:
 
 We're going to work through a series of files consolidating errors and warnings.
 
-- For the duration of this chat, all references to "destination file" refer to `string-interpolations.md`.
-- For the duration of this chat, all references to "the target theme" refer to errors and warnings related to string interpolations, and string interpolation handlers.
+- For the duration of this chat, all references to "destination file" refer to `docs/csharp/language-reference/compiler-messages/overloaded-operator-errors.md`.
+- For the duration of this chat, all references to "the target theme" refer to errors and warnings related to overflow, underflow, and checked and unchecked operators.
 
 The destination file already contains a skeleton for the final output.
 

.github/prompts/whats-new-net.md

@@ -51,7 +51,7 @@ In addition, follow these recommendations:
 - For the runtime and libraries articles, include extensive examples as well as links to recently updated articles related to the new feature. The examples should be at least as thorough as the examples from the source release notes.
 - Where applicable, the SDK article should include the samples.
 - The overview article generally doesn't include examples. Its purpose is to direct readers to more detailed information in other articles.
-- All APIs should be referenced using an `xref` style link, at least on first mention. Later mentions should be code-fenced in single back-ticks.
+- All APIs should be referenced using an `xref` style link as described in the `.github/copilot-instructions.md` file, at least on first mention. Later mentions should be code-fenced in single back-ticks.
 - All links to article in the `dotnet/docs` repository should be file relative.
 - Spell out acronyms on first use in each file.
 - Avoid gerund form in headings.

.openpublishing.redirection.ai.json

@@ -23,6 +23,11 @@
       "redirect_url": "/dotnet/ai/conceptual/ai-tools",
       "redirect_document_id": true
     },
+    {
+      "source_path_from_root": "/docs/ai/conceptual/vector-databases.md",
+      "redirect_url": "/dotnet/ai/vector-stores/overview",
+      "redirect_document_id": true
+    },
     {
       "source_path_from_root": "/docs/ai/get-started/dotnet-ai-overview.md",
       "redirect_url": "/dotnet/ai/overview",
@@ -40,6 +45,11 @@
       "source_path_from_root": "/docs/ai/how-to/work-with-local-models.md",
       "redirect_url": "/dotnet/ai"
     },
+    {
+      "source_path_from_root": "/docs/ai/quickstarts/build-vector-search-app.md",
+      "redirect_url": "/dotnet/ai/vector-stores/how-to/build-vector-search-app",
+      "redirect_document_id": true
+    },
     {
       "source_path_from_root": "/docs/ai/quickstarts/evaluate-ai-response.md",
       "redirect_url": "/dotnet/ai/evaluation/evaluate-ai-response",
@@ -98,6 +108,11 @@
       "source_path_from_root": "/docs/ai/tutorials/evaluate-with-reporting.md",
       "redirect_url": "/dotnet/ai/evaluation/evaluate-with-reporting",
       "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/docs/ai/tutorials/tutorial-ai-vector-search.md",
+      "redirect_url": "/dotnet/ai/vector-stores/tutorial-vector-search",
+      "redirect_document_id": true
     }
   ]
 }

.openpublishing.redirection.csharp.json

@@ -4,6 +4,50 @@
       "source_path_from_root": "/docs/csharp/fundamentals/types/namespaces.md",
       "redirect_url": "/dotnet/csharp/fundamentals/program-structure/namespaces"
     },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs0017.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs0028.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs0031.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/overloaded-operator-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs0220.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/overloaded-operator-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs0221.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/overloaded-operator-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs0463.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/overloaded-operator-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs0543.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/overloaded-operator-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs0594.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/overloaded-operator-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs0652.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/overloaded-operator-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs0659.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/overloaded-operator-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs1021.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/overloaded-operator-errors"
+    },
     {
       "source_path_from_root": "/docs/csharp/misc/cs0080.md",
       "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/generic-type-parameters-errors"
@@ -48,6 +92,10 @@
       "source_path_from_root": "/docs/csharp/misc/cs0401.md",
       "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/generic-type-parameters-errors"
     },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs0402.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+    },
     {
       "source_path_from_root": "/docs/csharp/misc/cs0403.md",
       "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/generic-type-parameters-errors"
@@ -132,6 +180,34 @@
       "source_path_from_root": "/docs/csharp/misc/cs1022.md",
       "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/using-directive-errors#cs1022"
     },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs1555.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs1556.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs1557.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs1558.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs1559.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs2017.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+    },
+    {
+      "source_path_from_root": "/docs/csharp/misc/cs5001.md",
+      "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+    },
     {
       "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs0304.md",
       "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/generic-type-parameters-errors"
@@ -867,6 +943,14 @@
             "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8795.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/partial-types"
         },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8802.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8803.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/entry-point-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8812.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/unsafe-code-errors"