#4 doc improvements