fixed docs in response to feedback