update docs per #369