documentation updated (please review)