> the protocol is desperately in need of an "XMPP: the Good Parts" doc.

It exists! https://docs.modernxmpp.org/