doc improvements