docs changes based on feedback
4 files changed