some doc improvements