DOC: simple doc improvements inside files