dotnet / dotnet/dotnet-api-docs
Distinguish between LTS, STS, and preview package-provided APIs
- Dominant language
- C#
- Stars
- 949
- Forks
- 1.7k
- Avg merge
- 3d 27m
- Merged PRs (30d)
- 49
Description
### Type of issue
Missing information
### Description
For package-provided APIs, please show whether the API is available in Long Term Support (LTS), Standard Term Support (STS), or only preview versions of the package. Or just show the lowest major version number in which the API is available.
This would be helpful for looking up APIs for use in projects that have a policy of not depending on STS versions of packages. Especially when using just a web browser on a smartphone, rather than projects in an IDE.
For example, the AddException method of System.Diagnostics.Activity is available starting from 9.0.\* (STS) versions of the System.Diagnostics.ActivitySource package; it is not available in 8.0.\* (LTS) versions. Currently, the topic shows “Package: System.Diagnostics.DiagnosticSource v10.0.0-preview.1.25080.5”, which is not that useful as a version number; I expect most developers of production applications would not want to reference such a preview version.
This issue is not specific to System.Diagnostics, though.
### Page URL
https://learn.microsoft.com/fi-fi/dotnet/api/system.diagnostics.activity.addexception?view=netstandard-2.0-pp
### Content source URL
https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.Diagnostics/Activity.xml
### Document Version Independent Id
2c0fff01-5891-c938-6050-3141ea958a6b
### Platform Id
4934afee-c38f-3119-528b-5df1e335def0
### Article author
@dotnet-bot
Contributor guide
Assessment
This issue has not been assessed yet.