more refactoring of  docs