Comment by antonvs
4 hours ago
> It's the only usable form of reference! I want all the details to be presented in a reference. Where else?
This is one of those "there are N types of people in the world". I'm with you, a detailed reference is the ideal scenario, but there seem to be many people who don't find that useful given their knowledge acquisition style.
Sure. But they explicitly claimed that a detailed reference is not useful as a reference.
Not any reference, though, but a specific style of one: A reference mostly written as a box-ticking exercise, written more for the writer than the reader. I like manpages, but the microcontroller manuals rarely reach those lofty heights.