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

[Bellarmine-Head]

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 dotnet/runtime#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

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.

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]

[dotnet-policy-service]

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

[berezovskyi]

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]

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 #10012.