docs are ok for a first pass