Coding

Как сделать, чтобы код не стал Legacy

1. Чётко обозначить решаемую задачу

2. Решить её на 100%, выполнить все возникшие при разработке TODO

3. Обеспечить интерфейс документацией, описать интерфейс (например командной строки), привести примеры использования, ВСЕ, имевшиеся в виду при разработке.

4. Не допускать подхода GIGO, проверять все значения - лучше чуть медленнее, чем сумничать, а потом будут сношать во все щели.

5. Концептуальная документация - описание разработки сверху вниз. Описание сверху вниз: какие компоненты в программе, как она разделена на модули. Какие модули какую функцию выполняют, почему разделение сделано именно так.

6. Документация данных: как данные хранятся, какие типы используются. Какие значения возможны, в каких случаях используются те или иные типы и структуры.

7. Описание динамики. Процессы загрузки, старта, работы, завершение. Процесс работы, создание, удаление сессий. Всё так же, от общего к частному.

8. Не надо комментариев a=a+1 "увеличиваем a на единицу" - не надо считать других разработчиков дебилами. Комментарий должен объяснять, ЗАЧЕМ a тут увеличивается на 1.

9. Диагностика. Диагностическая система должна позволять выявить, где произошла ошибка и с какими данными при этом работала программа - сохранение контекста от общего к частному, работа с которым привела к ошибке. Если ошибка связана только с неверными пользовательскими данными, пользователь должен получить информацию, что он не так делает и что он в своих действиях должен перепроверить.