Doc possible errors; check remote state format; update tests