doc updates based on feedback