avatar_decoration field in User object is undocumented

[drakon64]

Description

A User object returned by the Discord API returns an undocumented field named avatar_decoration.

Steps to Reproduce

Invoke an endpoint that returns a User object

Expected Behavior

The Discord API returns only fields documented at https://discord.com/developers/docs/resources/user#user-object-user-structure.

Current Behavior

The Discord API returns the fields documented at https://discord.com/developers/docs/resources/user#user-object-user-structure and an additional avatar_decoration field.

Screenshots/Videos

No response

Client and System Information

Own library

[AlmostSuspense]

the existence of undocumented fields is not a bug, they're just related to unreleased features. the rule of thumb is if it's not documented, ignore it

[drakon64]

How is this completed? The fields are still undocumented and the PR to actually resolve this is still open.

[ooliver1]

Likely since it was reported as a bug but it is not.

[drakon64]

Funny definition of 'completed'.

[yonilerner]

Like AlmostSuspense said, this is not a bug. If you'd prefer I not "complete" it, I could delete it instead :)

[drakon64]

If you want to point out where the solution is 'just ignore it', fine, I will admit that I missed it (although adding fields to a versioned API seems questionable). Otherwise, the fact that not all fields are documented should be documented for serialisation libraries that will throw an exception by default if unknown fields are attempted to be serialised (i.e KotlinX Serialization).

If you'd prefer I not "complete" it, I could delete it instead :)

Aside from being an incredibly immature response, this is also unhelpful in the event someone else runs into the same issue and wants to see the solution :)