search

dotnet / docs

This repository contains .NET Documentation.
https://learn.microsoft.com/dotnet
Creative Commons Attribution 4.0 International
4.29k stars 5.92k forks source link

Documentation for OS version in TFMs should have the "earliest supported OS version" #40988

Open Youssef1313 opened 6 months ago

Youssef1313 commented 6 months ago

Type of issue

Missing information

Description

See details in https://github.com/dotnet/sdk/issues/30103#issuecomment-2051870339

Starting with .NET SDK 9 Preview 3, the earliest bindings are supported.

For example, net8.0-ios17.0 will remain supported, regardless of whether new versions are released

So, it would be good to list the versions for every platform and for every TFM (and document that this works only with .NET 9 SDK Preview 3 and later)

Also, as the "earliest supported version" can change between previews and stable if I understand correctly, but once it's in stable, it won't change. So that would be good to note.

So, an extra column is needed in the table, which will be "earliest supported version". Then, in times of previews, there should be a note between parentheses that this version will change in stable SDK.

cc @rolfbjarne in case I got any info wrong.

Page URL

https://learn.microsoft.com/en-us/dotnet/standard/frameworks

Content source URL

https://github.com/dotnet/docs/blob/main/docs/standard/frameworks.md

Document Version Independent Id

4352856b-5ccf-8e62-48b4-3151340cac56

Article author

@gewarren

Metadata

rolfbjarne commented 6 months ago

So, it would be good to list the versions for every platform and for every TFM (and document that this works only with .NET 9 SDK Preview 3 and later)

If everything goes as planned, it will also work in a future service update to .NET 8.

In fact I'd hold off on changing anything until this change has been released to stable.