general doc improvements