update docs with review feedback
1 file changed