further doc additions