documentation

clarification of percentages.