minor formatting and clarification in docs.