further doc improvements