Merge branch 'dotnet:main' into main

Author: AndresMaqueo

.github/policies/disallow-edits.yml

@@ -19,6 +19,9 @@ configuration:
                   excludedFiles:
                     - xml/Microsoft.Extensions.FileSystemGlobbing/*
                     - xml/Microsoft.Extensions.FileSystemGlobbing.*/*
+              - filesMatchPattern:
+                  matchAny: true
+                  pattern: xml/System.CommandLine*/*
               - filesMatchPattern:
                   matchAny: true
                   pattern: xml/System.Composition/*

README.md

@@ -12,6 +12,9 @@ To contribute, see:
 
 - The [.NET Contributor Guide :ledger:](https://learn.microsoft.com/contribute/dotnet/dotnet-contribute) for instructions on procedures we use.
 - Issues labeled [`help wanted` :label:](https://github.com/dotnet/dotnet-api-docs/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22+) for ideas.
+- The API reference docs for some assemblies are maintained in the assembly's source code outside this repo. For those assemblies, edits to the XML here are auto-generated and ported, so docs for APIs in those assemblies should be updated by editing the source code comments. For more information, see [here](https://github.com/dotnet/runtime/blob/main/docs/coding-guidelines/adding-api-guidelines.md#documentation).
+
+  Namespaces and types whose docs are maintained in the assembly's source code repo set the [`open_to_public_contributors`](https://github.com/dotnet/dotnet-api-docs/blob/0ddbf94c587e7bdbbadc813a8b58fc4160a47b1f/docfx.json#L164) metadata to `false`. (That metadata disables the Edit button on the published docs.)
 
 ## :bookmark_tabs: Code of conduct
 

_zip/missingapi.yml

@@ -63,6 +63,10 @@ references:
   name: ChatMessage
   fullname: OpenAI.Chat.ChatMessage
   href: https://github.com/openai/openai-dotnet/blob/main/api/OpenAI.netstandard2.0.cs
+- uid: OpenAI.Chat.ChatResponseFormat
+  name: ChatResponseFormat
+  fullname: OpenAI.Chat.ChatResponseFormat
+  href: https://github.com/openai/openai-dotnet/blob/main/api/OpenAI.netstandard2.0.cs
 - uid: OpenAI.Chat.ChatTool
   name: ChatTool
   fullname: OpenAI.Chat.ChatTool
@@ -123,6 +127,10 @@ references:
   name: ResponseItem
   fullname: OpenAI.Responses.ResponseItem
   href: https://github.com/openai/openai-dotnet/blob/main/api/OpenAI.netstandard2.0.cs
+- uid: OpenAI.Responses.ResponseTextFormat
+  name: ResponseTextFormat
+  fullname: OpenAI.Responses.ResponseTextFormat
+  href: https://github.com/openai/openai-dotnet/blob/main/api/OpenAI.netstandard2.0.cs
 - uid: OpenAI.Responses.ResponseTool
   name: ResponseTool
   fullname: OpenAI.Responses.ResponseTool

docfx.json

@@ -147,6 +147,7 @@
       "ms.topic": {
         "api/Microsoft.Extensions**": "generated-reference",
         "api/Microsoft.Extensions.FileSystemGlobbing**": "reference",
+        "api/System.CommandLine**": "generated-reference",
         "api/System.Composition**": "generated-reference",
         "api/System.Diagnostics.EventLog.Messages**": "generated-reference",
         "api/System.Formats.Asn1**": "generated-reference",
@@ -163,18 +164,20 @@
       },
       "open_to_public_contributors": {
         "api/Microsoft.Extensions**": false,
+        "api/System.CommandLine**": false,
         "api/System.Composition**": false,
         "api/System.Diagnostics.EventLog.Messages**": false,
         "api/System.Formats.Asn1**": false,
         "api/System.Formats.Cbor**": false,
         "api/System.Formats.Nrbf**": false,
-        "api/System.Linq.AsyncEnumerable.yml": false,
-        "api/System.Linq.IOrderedAsyncEnumerable-1.yml": false,
         "api/System.Net.ServerSentEvents**": false,
         "api/System.Numerics.Tensors**": false,
+        "api/System.Runtime.Serialization.Schema**": false,
+
+        "api/System.Linq.AsyncEnumerable.yml": false,
+        "api/System.Linq.IOrderedAsyncEnumerable-1.yml": false,
         "api/System.Runtime.Serialization.ISerializationCodeDomSurrogateProvider.yml": false,
         "api/System.Runtime.Serialization.ImportOptions.yml": false,
-        "api/System.Runtime.Serialization.Schema**": false,
         "api/System.Runtime.Serialization.XsdDataContractExporter.yml": false
       }
     },

quest-config.json

@@ -6,30 +6,5 @@
     },
     "ImportTriggerLabel": ":world_map: reQUEST",
     "ImportedLabel": ":pushpin: seQUESTered",
-    "ParentNodes": [
-        {
-            "Semester": "Bromine",
-            "ParentNodeId": 410746
-        },
-        {
-            "Label": "user-feedback",
-            "Semester": "Selenium",
-            "ParentNodeId": 286039
-        },
-        {
-            "Label": "doc-bug",
-            "Semester": "Selenium",
-            "ParentNodeId": 286039
-        },
-        {
-            "Label": "doc-update",
-            "Semester": "Selenium",
-            "ParentNodeId": 286038
-        },
-        {
-            "Semester": "Selenium",
-            "ParentNodeId": 308199
-        }
-    ],
     "DefaultParentNode": 410746
 }

snippets/csharp/System.Collections.Generic/ListT/.ctor/project.csproj

@@ -0,0 +1,8 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net9.0</TargetFramework>
+  </PropertyGroup>
+
+</Project>

snippets/csharp/System.Collections.Generic/ListT/.ctor/source.cs

@@ -2,68 +2,69 @@
 using System;
 using System.Collections.Generic;
 
-public class Example
+public partial class Program
 {
     public static void Main()
     {
-        List<string> dinosaurs = new List<string>(4);
+        List<string> animals = new List<string>(4);
 
-        Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);
+        Console.WriteLine("\nCapacity: {0}", animals.Capacity);
 
-        dinosaurs.Add("Tyrannosaurus");
-        dinosaurs.Add("Amargasaurus");
-        dinosaurs.Add("Mamenchisaurus");
-        dinosaurs.Add("Deinonychus");
+        animals.Add("Cat");
+        animals.Add("Dog");
+        animals.Add("Squirrel");
+        animals.Add("Wolf");
 
         Console.WriteLine();
-        foreach(string s in dinosaurs)
+        foreach (string animal in animals)
         {
-            Console.WriteLine(s);
+            Console.WriteLine(animal);
         }
 
-        Console.WriteLine("\nIList<string> roDinosaurs = dinosaurs.AsReadOnly()");
-        IList<string> roDinosaurs = dinosaurs.AsReadOnly();
+        Console.WriteLine("\nIList<string> roAnimals = animals.AsReadOnly()");
+        IList<string> roAnimals = animals.AsReadOnly();
 
         Console.WriteLine("\nElements in the read-only IList:");
-        foreach(string dinosaur in roDinosaurs)
+        foreach (string animal in roAnimals)
         {
-            Console.WriteLine(dinosaur);
+            Console.WriteLine(animal);
         }
 
-        Console.WriteLine("\ndinosaurs[2] = \"Coelophysis\"");
-        dinosaurs[2] = "Coelophysis";
+        Console.WriteLine("\nanimals[2] = \"Lion\"");
+        animals[2] = "Lion";
 
         Console.WriteLine("\nElements in the read-only IList:");
-        foreach(string dinosaur in roDinosaurs)
+        foreach (string animal in roAnimals)
         {
-            Console.WriteLine(dinosaur);
+            Console.WriteLine(animal);
         }
     }
 }
 
-/* This code example produces the following output:
+/*
+    This code example produces the following output:
 
-Capacity: 4
+    Capacity: 4
 
-Tyrannosaurus
-Amargasaurus
-Mamenchisaurus
-Deinonychus
+    Cat
+    Dog
+    Squirrel
+    Wolf
 
-IList<string> roDinosaurs = dinosaurs.AsReadOnly()
+    IList<string> roAnimals = animals.AsReadOnly()
 
-Elements in the read-only IList:
-Tyrannosaurus
-Amargasaurus
-Mamenchisaurus
-Deinonychus
+    Elements in the read-only IList:
+    Cat
+    Dog
+    Squirrel
+    Wolf
 
-dinosaurs[2] = "Coelophysis"
+    animals[2] = "Lion"
 
-Elements in the read-only IList:
-Tyrannosaurus
-Amargasaurus
-Coelophysis
-Deinonychus
- */
+    Elements in the read-only IList:
+    Cat
+    Dog
+    Lion
+    Wolf
+*/
 // </Snippet1>