add doc and fix a vet issue so that `make ready` passes