From 969391c93ecd5c06ee8cead922028b42c1269e5b Mon Sep 17 00:00:00 2001 From: Khujrat Shaikh Date: Fri, 6 Feb 2026 12:44:24 +0530 Subject: [PATCH 1/2] Docs: minor wording cleanup in README Clarify description of API reference documentation --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index afab88c7adcf0..b26eef9f495ad 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ This repository contains the conceptual documentation for .NET. The [.NET docume - [Entity Framework 6/Core](https://github.com/dotnet/EntityFramework.Docs) - [Community toolkit](https://github.com/MicrosoftDocs/communitytoolkit) -API reference documentation is published from the following repositories. The following reference API repositories are public. Only some accept issues and pull requests, although some folders in `dotnet-api-docs` use the product repository as the source of truth. Others are pass-through repositories because API reference is generated directly from the `///` in the product source. +API reference documentation is published from the following repositories. All listed reference API repositories are public. Only some accept issues and pull requests, although some folders in `dotnet-api-docs` use the product repository as the source of truth. Others are pass-through repositories because API reference is generated directly from the `///` in the product source. - [.NET API reference](https://github.com/dotnet/dotnet-api-docs) - [.NET MAUI API reference](https://github.com/dotnet/maui-api-docs) From eb729a77bd451b40298190c75505387da709fe7d Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Fri, 6 Feb 2026 08:16:17 -0800 Subject: [PATCH 2/2] Revise documentation repository links in README Updated the list of repositories for .NET documentation and API references. --- README.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index b26eef9f495ad..1f2cc1cdaf391 100644 --- a/README.md +++ b/README.md @@ -9,16 +9,16 @@ [![GitHub pulls-unmerged](https://img.shields.io/github/issues-search/dotnet/docs?label=unmerged%20pull%20requests&query=is%3Apr%20is%3Aclosed%20is%3Aunmerged&color=red)](https://github.com/dotnet/docs/pulls?q=is%3Apr+is%3Aclosed+is%3Aunmerged) [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/9215/badge)](https://www.bestpractices.dev/projects/9215) -This repository contains the conceptual documentation for .NET. The [.NET documentation site](https://learn.microsoft.com/dotnet) is built from multiple repositories in addition to this one: +This repository contains the conceptual documentation for .NET. The [.NET documentation site](https://learn.microsoft.com/dotnet) is built from multiple repositories: -- [ASP.NET Core](https://github.com/dotnet/AspNetCore.Docs) -- [.NET Aspire](https://github.com/dotnet/docs-aspire) -- [.NET Desktop workloads](https://github.com/dotnet/docs-desktop) -- [.NET MAUI](https://github.com/dotnet/docs-maui) -- [Entity Framework 6/Core](https://github.com/dotnet/EntityFramework.Docs) +- [.NET docs](https://github.com/dotnet/docs) +- [ASP.NET Core docs](https://github.com/dotnet/AspNetCore.Docs) +- [.NET Desktop workloads docs](https://github.com/dotnet/docs-desktop) +- [.NET MAUI docs](https://github.com/dotnet/docs-maui) +- [Entity Framework docs](https://github.com/dotnet/EntityFramework.Docs) - [Community toolkit](https://github.com/MicrosoftDocs/communitytoolkit) -API reference documentation is published from the following repositories. All listed reference API repositories are public. Only some accept issues and pull requests, although some folders in `dotnet-api-docs` use the product repository as the source of truth. Others are pass-through repositories because API reference is generated directly from the `///` in the product source. +API reference documentation is published from the following repositories: - [.NET API reference](https://github.com/dotnet/dotnet-api-docs) - [.NET MAUI API reference](https://github.com/dotnet/maui-api-docs) @@ -27,6 +27,8 @@ API reference documentation is published from the following repositories. All li - [Roslyn API reference](https://github.com/dotnet/roslyn-api-docs) - [Community toolkit API reference](https://github.com/MicrosoftDocs/community-toolkit-api-ref-dotnet) +These API reference doc repositories are public. Only some accept issues and pull requests. Others are pass-through repositories because API reference is generated directly from the `///` in the product source. Some folders in `dotnet-api-docs` use the product repository as the source of truth. + The C# language specification documentation comes from the following two repositories: - [C# language design](https://github.com/dotnet/csharplang)