doc improvements - sent to marmlade