writing more useful docs