I agree that we should have some sort of convention (with Scribble support) for this kind of information. In some cases I think HTML accordions would be useful. For example, an “Exceptions” accordion that lists the possible errors, what they mean, how to fix them, etc.

I’d love that!