improved wording docs