Тут опять-таки все продумано до нас. Все ваши функции и методы должны содержать минимум кода и выполнять ТОЛЬКО ОДНО действие. Если метод содержит более ~10 строк - его лучше разбить на два метода. Такие короткие функции и методы будут понятны без комментариев. Перед самым методом ставим комментарии чтобы их могла понять система автоматического дкументирования. Например:
/**
* Метод делающий то-то
* @param first первый параметр
* @param second второй параметр
* @return возвращаемое значение
*/
