Skip to content

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

Open
@KalleOlaviNiemitalo

Description

@KalleOlaviNiemitalo

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions