lots of doc improvements