dotnet / dotnet/dotnet-api-docs

Distinguish between LTS, STS, and preview package-provided APIs

Open
#11,091 1 comment 0 reactions 1 assignee Claimed by @gewarren View on GitHub
area-Infrastructure untriaged
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.