Updated documentation preparing for refactoring