Document the exception hierarchy

[lovelydinosaur]

We've put a stack of great work into this for 0.14 - let's also show it off.

[florimondmanca]

Refs #949 (for visibility there) :-)