Традиционные подходы к разработке программного обеспечения предполагают создание подробной проектной документации. Это логично: документ описывает архитектуру, цели и подходы, которые помогают всем участникам команды понимать, как движется проект. Однако в своей статье Preferring throwaway code over design docs Даг Тёрнер высказывает спорное, но интересное мнение: вместо того чтобы писать проектные документы, лучше писать временный код, который можно выбросить.
Давайте разберём, что именно предлагает автор, какие у этого подхода преимущества и где кроются подводные камни.
🛠 Что такое временный код?
Временный код (или throwaway code) — это экспериментальный код, который пишется, чтобы проверить идеи на практике. Он не предназначен для длительного использования и часто выбрасывается после того, как становится ясно, какой путь в разработке выбрать.
Пример процесса:
- ✍ Пишется базовая реализация. Разработчик быстро создаёт прототип функции или системы.
- 🔄 Тестирование идей. Код помогает понять, насколько рабочая идея подходит для проекта.
- 🗑 Удаление или доработка. Если подход работает, его переписывают «на чистовик». Если нет, код просто выбрасывают.
📃 Почему автор считает проектные документы устаревшими?
Проектная документация — это теоретическая модель, которая должна описывать, как система будет работать. Однако, по мнению Дага Тёрнера, у неё есть несколько проблем:
- 🕰 Долгое создание. Написание документа занимает время, которое можно было бы потратить на эксперимент.
- 🧩 Ограниченная практичность. Даже самая подробная документация не гарантирует, что идеи будут успешно работать в реальной среде.
- ❌ Риск устаревания. В быстро меняющихся проектах документация часто становится неактуальной уже через несколько недель.
Временный код, по словам автора, даёт более быстрый и точный способ оценить работоспособность идей.
🚀 Преимущества подхода с временным кодом
- 💡 Быстрая проверка гипотез. Вместо долгих обсуждений и написания теории вы сразу переходите к практике.
- 🤝 Лучшее понимание командой. Рабочий код даёт больше информации, чем текст, особенно для технических специалистов.
- 🔄 Гибкость. Код можно быстро изменить или выбросить, если идея не сработала.
⚠ Недостатки и вызовы
Несмотря на преимущества, у подхода есть и свои подводные камни:
- 🗂 Отсутствие документации. Без документации проект становится труднее поддерживать и масштабировать, особенно для новых членов команды.
- 📉 Качество кода. Временный код часто пишется быстро и может быть не оптимизирован или содержать ошибки.
- ❓ Потеря исторической информации. Если идея была отброшена, команда может забыть причины, почему это произошло.
📚 Интересные факты о временном коде и документации
- ⚡ Метод MVP (минимально жизнеспособный продукт). Временный код часто используется для создания прототипов в стартапах, чтобы быстро проверить идеи.
- 🖥 Facebook и Google. Эти компании активно используют временный код для тестирования новых функций, что помогает им быстрее выпускать обновления.
- 🧠 Код как коммуникация. Многие разработчики считают, что хорошо написанный код объясняет себя лучше любой документации.
🧠 Моё мнение: баланс между кодом и документацией
На мой взгляд, идея временного кода вместо документации — это смелый, но неоднозначный подход. Временный код действительно помогает быстро проверить идеи, но я не думаю, что он полностью заменяет документацию.
Документация остаётся важной для больших команд и сложных проектов, где понимание архитектуры критично. Однако для небольших проектов или стартапов временный код может быть отличным способом ускорить процесс разработки.
🔮 Будущее подхода
Возможно, лучшим решением станет комбинированный подход:
- ✍ Создание минимальной документации. Писать краткие и понятные документы, которые дополняют временный код.
- 🚧 Использование инструментов для автоматизации. Например, генерировать документацию из комментариев кода.
- 💾 Сохранение временного кода. Даже если он выброшен, его можно хранить в отдельной ветке репозитория, чтобы вернуться к идеям в будущем.
Источники:
- Методы разработки MVP и экспериментов в IT-проектах.
- Опыт использования временного кода в крупных IT-компаниях.