@evelyn@misskey.bubbletea.dev Dunno, I think that's more just a layout/documentation thing; it's actually much clearer with Matrix what you're supposed to be implementing than with the pick-and-mix XEPs of which many stick around in a de-facto-obsolete state, but the single-page format is what makes things miserable.
The new layout does improve on this a bit, at least: https://spec.matrix.org/v1.2/client-server-api/ -- I think more 'modular' writing would go a long way to get the Matrix spec into better shape, even if it's still a monolithic spec.