Document things that can go wrong (even though methods self-recover)