housekeeping update, docs, description, code comments.