further doc additions ..