(this is obv subjective and again it being a spec it probably has to be this way. i guess what i want is for official docs to not only have specs but to have docs too — i.e. "here's what you need to do", not "here's an exhaustive description of what a thing is")
If you have a fediverse account, you can quote this note from your own instance. Search https://bsky.brid.gy/convert/ap/at://did:plc:fpruhuo22xkm5o7ttr2ktxdo/app.bsky.feed.post/3mao7xgy3rs2n on your instance and quote it. (Note that quoting is not supported in Mastodon.)