[reaperman]

Perhaps Espressif will improve this situation. Seems like their product line is generally decently documented at the diagram-block level at least. Obviously with embedded platforms, "proper" documentation can stretch into the range of 1000+ pages (e.g. what you'd expect to see from ARM), and Espressif doesn't deliver documentation to that level of detail with their ESP32 / ESP8266 offerings.

But despite the lack of super granular detail, I haven't ever noticed their high-level documentation being straight-up misleading like that.