CFY-1377 update docs some more