documentation changes after user feedback