Doc possible errors; check remote state format; fix tests