mostly doc improvements