документирование и небольшой рефакторинг имен методов