Known (and unknown) errors

The docs are a bit sparse.