Standard: Which document is the correct .NET Standard compatibility matrix?

[sam-wheat]

Which document is the correct .NET Standard compatibility matrix?

.NET Standard Library

or

.NET Standard Versions

Make sure your answer confirms this question

[dasMulli]

(related: https://github.com/dotnet/standard/pull/203)

[sam-wheat]

I believe the doc is wrong but @weshaggard is the best to confirm. (@Petermarcu)

This is something that we're walking a fine line on. I know we intend netstandard 1.5 and 1.6 libraries be able to be loaded on 4.6.1 once we finish (@Petermarcu)

I believe the docs here may be trying to articulate how it will work. (@Petermarcu)

The documents we have in this repo aren't reflecting current shipped tooling but instead are reflecting the tooling that will ship with .NET Standard 2.0 (@weshaggard)

I agree it is a little confusing we are trying to make the docs in our master repo forward looking (@weshaggard)

We probably should just have a section in these docs that highlight what it currently is and what it will be. @terrajobst owns the docs so I will let him chime in on how to structure and convey the message. (@weshaggard)

I cannot believe what I am reading in these posts. Do you guys realize there are thousands of develpers who are trying to follow this project? Do you realize that these documents represent our vision of how this software should work?

Is this why posts such as this one are received with such resounding silence?

How is it possible that you know these documents are incorrect but you dont update them to show the current state of the project?

[weshaggard]

@terrajobst can you please help clarify this information in the documents in the repo?

[terrajobst]

To close the loop for folks reading this issue. Both documents are correct but:

• The documentation describes the state of the shipped product, which is .NET Standard 1.x.
• GitHub repo describes the state after shipping .NET Standard 2.0, which is work in progress.

[sam-wheat]

Thanks to all at MSFT!