More improvements to the captions docs about error handling and such things.