search

dotnet / dotnet-api-docs

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

A few JsonObject methods are listed as being available in .NET 8, but in reality they aren't #10501

Closed Bellarmine-Head closed 1 week ago

Bellarmine-Head commented 3 weeks ago

Type of issue

Other (describe below)

Description

[Enter feedback here] The documentation for JsonObject methods GetAt, IndexOf, SetAt, RemoveAt, Insert say that they are available in .NET 8.

E.g. https://learn.microsoft.com/en-us/dotnet/api/system.text.json.nodes.jsonobject.indexof?view=net-8.0

This is annoying, because I looked for them in vain, and thought I was getting something wrong.

But in fact, these methods are being added in .NET 9 and are not available in any previous version.

See https://github.com/dotnet/runtime/issues/102932

Page URL

https://learn.microsoft.com/en-us/dotnet/api/system.text.json.nodes.jsonobject.indexof?view=net-8.0

Content source URL

https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.Text.Json.Nodes/JsonObject.xml

Document Version Independent Id

75219c28-7f0a-b336-60ff-09fbe63729a2

Article author

@dotnet-bot

dotnet-issue-labeler[bot] commented 3 weeks ago

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.

dotnet-issue-labeler[bot] commented 3 weeks ago

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.

Bellarmine-Head commented 3 weeks ago

image

dotnet-policy-service[bot] commented 3 weeks ago

Tagging subscribers to this area: @dotnet/area-system-text-json

berezovskyi commented 2 weeks ago

same for https://learn.microsoft.com/en-us/dotnet/api/system.text.json.jsonelement.deepequals?view=net-8.0#system-text-json-jsonelement-deepequals(system-text-json-jsonelement-system-text-json-jsonelement)

gewarren commented 1 week 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.