improve wording of docs