dotnet / website-feedback

This repo is for dot.net feedback including get started tutorial issues from the site.
MIT License
0 stars 1 forks source link

Documentation Improvement - Include .NET 5 - Supported OS versions matrix #3

Open abarberenaCPDS opened 3 years ago

abarberenaCPDS commented 3 years ago

Description

I'd like to suggest to improve the documentation and include the supported OS versions in the documentation page.

The matrix can be found in

The following website should include the matrix

As an example, for this issue https://github.com/dotnet/runtime/issues/57983, took ages to figure out something very simple that an MS employee kindly clarified.

mairaw commented 3 years ago

Thank you for your feedback @abarberenaCPDS. I'll check if there's an easy way to at least add a link to the support matrix doc from that page.

/cc @leecow @rbhanda @richlander in case you have other ideas

leecow commented 3 years ago

A link to the appropriate matrix makes sense and will connect the dots. The alternative is to move the matrix into the docs. Either route is fine as long as the information is maintained in a single location.

mairaw commented 3 years ago

Tagging @adegeo to see what he thinks.

adegeo commented 3 years ago

The matrix information is pretty much already in the docs, it's the standard install articles:

https://docs.microsoft.com/en-us/dotnet/core/install/linux https://docs.microsoft.com/en-us/dotnet/core/install/windows?tabs=net50 https://docs.microsoft.com/en-us/dotnet/core/install/macos

mairaw commented 3 years ago

Ah ok. I was thinking of a single URL target to not add too many new links to an already busy page.

It seems that now we're duplicating the info in two places. Should we keep docs only and update links to go there?

adegeo commented 3 years ago

It would be great to get the product team updating the msdocs instead of github docs. However, the msdocs focus more on the current state while the github docs retain historical info.