docs

This repository contains the source files for the official .NET documentation published at learn.microsoft.com/dotnet. NET is Microsoft's platform for building and running software applications, covering languages like C#, F#, and Visual Basic. This repo holds the conceptual guides and tutorials that explain how the platform works, while API reference documentation lives in a separate set of repositories.

The documentation is built from multiple GitHub repositories that each cover a different part of the .NET ecosystem. This particular repo handles the core .NET documentation. Other repos cover ASP.NET Core (for building web applications), .NET MAUI (for mobile and desktop apps), Entity Framework (for working with databases), and .NET Desktop workloads. All of these feed into the same published documentation site.

The project is open to community contributions. Readers can click a feedback button at the bottom of any published page to open an issue in the right repository automatically. Contributors can submit pull requests to fix errors, improve explanations, or add examples. The team reviews and merges pull requests on a regular basis, though they close contributions that go inactive for more than 30 days.

The repository uses several automated workflows to maintain quality, including a Markdown linter, a link checker, a build verifier that flags broken redirects, and a monthly check that identifies documentation pages still targeting unsupported versions of .NET.