more docu improvements

Yet more docu wording improvements. Please pull. Thanks.