documentation update after code refactoring