Recently I've finished documentation of standard Firmata protocol (for myself mostly).
Take a look at https://github.com/martin-eden/firmata_protocol/blob/main/protocol.md
One style, railroad diagrams and no excerpts from C code.
(This is just announce for maintainer, not an issue. Maybe it can be added to some list (as with list of implementations). You can resolve it.)