Читать книгу Полезные конспекты книг и авторские заметки по информационным технологиям. Без формул онлайн

Аргументы должны иметь естественную связь и естественный порядок.

Хорошо подумать перед созданием тернарной функции.

Упаковывать аргументы в объекты.

Если переменное количество равноправных аргументов – упаковать в List.

Хорошее имя функции способно объяснить смысл функции, порядок и смысл ее аргументов.

В унарных функциях функция и аргумент должны образовывать естественную пару «глагол – существительное».

Функция не делает чего-то скрытно от пользователя.

Нет побочных временных привязок функции.

Нет побочных эффектов.

Нет причин лишний раз обращаться к сигнатуре функции (нет повторных заходов).

Выходных аргументов следует избегать.

Функция может изменять состояние только владельца.

Функция либо что-то делает (команда), либо отвечает на какой-либо вопрос (запрос).

Функция либо изменяет состояние объекта, либо возвращает информацию об этом объекте.

Исключена неоднозначность имен функций.

Функции-команды не возвращают коды ошибок.

Вместо возвращения кодов ошибок используются исключения.

Тела блоков try/catch выделены в отдельные функции.

Функции выполняют 1 операцию.

Обработка ошибок – одна операция.

Нет магнитов зависимостей – классов или перечислений, импортируемых и используемых многими другими классами.

Нет дублирования алгоритмов.

Уменьшена вероятность ошибки.

Goto не используется.

Много return, break, continue допускается в компантных функциях.

В коде сначала излагаются мысли, а затем «причесываются».

Система рассматривается как история, которую нужно рассказать.

Комментарии – неизбежное зло.

Только код может правдиво сообщить, что он делает.

Свести использование комментариев к минимуму.

Комментирование – причина повысить качество кода.

Вместо юридических комментариев – ссылки на них.

Информацию лучше передавать в имени функции.

Использовать комментарии для информации о намерении.

Комментарии – в случае неудобочитаемых форм данных.

Комментарии для предупреждения о последствиях.

Комментарии TODO на будущее.

Комментарии для подчеркивания важности обстоятельства.

Не делать комментарии на скорую руку.