[logicallee]

If it's programmatically self-describing, nobody ever has to read it.

EDIT: I mean as opposed to something like json that has what the authors describe as out-of-band schema.

[bellerocky]

You have to read it when you want to look at what is going over the wire. Like with Wireshark or just inspecting network traffic.

[iheart2code]

This is exactly what I was thinking. Also, when inheriting projects from other developers that didn't produce documentation.