Docs: Update .NET Architectural Components for .NET 5

Created on 19 Jul 2017  路  8Comments  路  Source: dotnet/docs

https://docs.microsoft.com/en-us/dotnet/standard/components

The Introduction to .NET in the Fundamentals TOC introduces .NET 5 as the main implementation of .NET going forward and will only briefly mention other implementations of .NET. This article will be the link target for "more information" about other implementations of .NET.

P1 doc-enhancement

Most helpful comment

I'd like to see this document cover:

  1. The different implementation platforms for .NET Standard.
  2. The relationship between those implementations.
  3. How the architecture improves platform independence
  4. What .NET Standard really means.

All 8 comments

@BillWagner and I discussed and we think this one should be improved and cover more than just the different terminology.

@BethMassi @terrajobst do we have a new diagram ready we could use for https://docs.microsoft.com/en-us/dotnet/standard/components?

I'd like to see this document cover:

  1. The different implementation platforms for .NET Standard.
  2. The relationship between those implementations.
  3. How the architecture improves platform independence
  4. What .NET Standard really means.

@BillWagner That's basically the goal of this doc. It's pretty impossible to make sense of .NET without something like this. I initially wrote it because I got feedback about there being confusion about what .NET Standard is. This is back when we were still calling it a "piece of paper", which I don't think stuck well with anyone. We're now just saying that ".NET Standard = APIs everywhere", which is the right way to phrase it. Changing ".NET Standard Library" to ".NET Standard" is mostly what we should do here, IMO.

@BethMassi That diagram leaves something to be desired. The goal is to show the elements of a .NET implementation and .NET Standard and how they relate to each other, but the boxes in the top row of this diagram are app types/platforms, not .NET implementations or elements of one, such as BCLs, app frameworks, etc. What I think would work better is something more like Immo's diagram but with a few more details and a little more accuracy about the not-perfect match between .NET Standard and the various BCLs.

@cartermp I agree with the .NET Standard Library => .NET Standard change.

The diagram update will also help.

I'd also change the title "Architectural components" sounds like a catalog of the parts that make up .NET. This topic is more of an overview of the .NET ecosystem architecture. That's very useful.

We're still waiting for the new diagram. Beth and co are still discussing this,

Was this page helpful?
0 / 5 - 0 ratings

Related issues

stanuku picture stanuku  路  3Comments

gmatv picture gmatv  路  3Comments

svick picture svick  路  3Comments

mekomlusa picture mekomlusa  路  3Comments

tswett picture tswett  路  3Comments