Some (many?) people learn better from concrete examples and generalize from them.

Not just that, but it's also useful to have examples to validate a) your understanding of the spec, and b) product's actual adherence to the spec.

Yeah, I plan on improving the formatting and adding a few more examples. There were even still some typos in the piece. To be honest, I didn't plan on sharing it yet; I just figured it might be helpful for the OP, so I shared it early.

I also think the docs are pretty good. There's just something about seeing the actual network requests that helps clarify things for me.