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

[zspitz]

There are two sections of the C# documentation which seem to fill overlapping if not identical areas, under Docs -> .NET -> C# guide:

• C# concepts (for example, this page)
• C# Programming guide

For example, both have sections on LINQ (here and here) and expression trees (here and here).

Which hierarchy should be preferred?

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

[BillWagner]

Hi :wave: @zspitz

I'll answer the second question first:

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

Yes! Cataloging the duplication would be very useful.

Which hierarchy [C# concepts, or C# Fundamentals] should be preferred?

This is an area where I'm working now. I'm experimenting with a few possible ways to organize all the content. The challenge is providing an organization that works for an audience that spans all experience levels, both with the C# language and programming in general. I hope to have a draft that I can publish as an issue in the next couple weeks.

So, in time, I expect both the "concepts" section and the "programming guide" sections to be moved around to support different jouneys.

In the short term, I'd prefer moving content into the programming guide.