Known (and unknown) errors

These docs are a bit sparse.