repair function documentation; start refactoring doc generation