[Книга] BaseCode - полевое руководство по долговечному коду

Полевое руководство, содержащее реальные практики, которые помогут вам писать менее сложный и более читаемый код. Я пишу код 20 лет. За это время я работал над сотнями проектов с десятками команд. Я обнаружил, что самое важное качество долговечного кода - это удобочитаемость.

Когда я только начал писать код, я просто написал код, который работал. Какая разница, пока это работает? Спустя годы я приложил все усилия, чтобы мой код соответствовал всем лучшим практикам. Мы знаем, что наш код слишком сложен. Это легко реализовать, но трудно избежать. Мы слишком быстро отказываемся от таких качеств, как удобочитаемость, и принимаем сложность по мере необходимости. Нам нужно вернуться к основам написания кода для других людей. Это цель BaseCode.

Это полевой справочник, а не книга.

BaseCode состоит из 10 методов написания читаемого кода и содержит более 40 примеров кода.

Эти практики сосредоточены на:

• Написание кода, в котором приоритет отдается удобочитаемости для людей, а не для компьютера
• Избегайте гниения кода с помощью анализа и автоматизации
• Распутывание вложенного кода для повышения визуальной честности и сокращения накладных расходов читателя
• Представляем объекты для инкапсуляции сложности
• Рефакторинг длинных блоков кода за счет понимания уровней чтения
• Упрощение именования с учетом контекста и времени
• Использование кода в качестве основного сигнала, а не комментариев
• Избегайте ненужного кода за счет использования разумных возвращаемых значений
• Отсрочка необходимости удаления дублирования с помощью правила трех
• Улучшение потока кода с помощью симметрии
• Откладывание дизайнерских решений, чтобы уменьшить беспокойство при написании кода

Это не книга, это практическое руководство. BaseCode применяет реальные практики к повседневному коду. Нет никакого пуха. Нет теории. Я решаю общие проблемы и использую код, чтобы показать решения.

Каждая тема аккуратно организована в главы. Если у вас много вложенного кода, прочтите «Вложенный код». Если вы хотите разделить длинные методы, переходите к Big Blocks. Вы можете прочитать его от корки до корки или перейти к интересующим вас практикам.