docs: add docs for the new api.

Remove *also*/*same*: ``you will also receive this error`` or ``you will receive the same error``.