major refactoring of the docs