update docs with review feedback
2 files changed