dotnet / dotnet-api-docs

.NET API reference documentation (.NET 5+, .NET Core, .NET Framework)
https://docs.microsoft.com/dotnet/api/
Other
727 stars 1.56k forks source link

Metrics instrument of type Guage<> not available in .NET 8 #10380

Closed melwynpkb closed 3 weeks ago

melwynpkb commented 2 months ago

Type of issue

Other (describe below)

Description

Guage<> is not supported in .NET 8 but the documentation seems to indicate it does. See .NET 8 and .NET 9 branches below https://github.com/dotnet/runtime/tree/main/src/libraries/System.Diagnostics.DiagnosticSource/src/System/Diagnostics/Metrics

Page URL

https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.metrics.gauge-1?view=net-8.0

Content source URL

https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.Diagnostics.Metrics/Gauge`1.xml

Document Version Independent Id

40be00e4-b2c4-2443-541c-dc6838a74666

Article author

@dotnet-bot

dotnet-policy-service[bot] commented 2 months ago

Tagging subscribers to this area: @tommcdon

divyeshio commented 1 month ago

Not only Gauge<> but other types in the namespace like MeterOptions, IMeterFactory that are unavailable below .net 8 are also showing up as available in .net 6 and 7. But xml files are fine, I think there's some issue with doc page generation?

gewarren commented 3 weeks ago

Thank you for the feedback. The NuGet package is compatible with down-level versions, which is why the older versions are shown in the Applies to table. But we've also received a lot of feedback that this is too confusing. We have a design change in the works to hopefully make this less confusing. Closing as duplicate of https://github.com/dotnet/dotnet-api-docs/issues/10012.