I've added/altered documentation. Please review.