There are a couple data structures which don't fully match the documentation, like GuildMember, Message, and a couple of others.
It would be good to match the spec more precisely so that the full API can be used.
Additionally, it would be good if the data structures followed the order that is presented in the documentation as well.