more docs

Please review.