dotnet / dotnet/docs

Consolidate "C# concepts" and "C# programming guide"

Open
#28,027 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
No language data
Stars
4.8k
Forks
6.1k
Avg merge
15h 21m
Merged PRs (30d)
370

Description

There are two sections of the C# documentation which seem to fill overlapping if not identical areas, under [Docs](https://docs.microsoft.com/en-us/) -> [.NET](https://docs.microsoft.com/en-us/dotnet/) -> [C# guide](https://docs.microsoft.com/en-us/dotnet/csharp/):

* C# concepts (for example, [this page](https://docs.microsoft.com/en-us/dotnet/csharp/nullable-references))
* [C# Programming guide](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/)

For example, both have sections on LINQ ([here](https://docs.microsoft.com/en-us/dotnet/csharp/linq/) and [here](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/concepts/linq/)) and expression trees ([here](https://docs.microsoft.com/en-us/dotnet/csharp/expression-trees) and [here](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/concepts/expression-trees/)).

Which hierarchy should be preferred?

Would it be useful to draw up a table of the duplicate sections?

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.