Когда Вы пишете документацию к проекту?

Question

[Timofey Barinov]

Важно: Речь идёт не о документации в коде, а обо всём проекте в целом(как использовать, как настраивать)

Есть два варианта:

В процессе написания:
Пишете доки совместно с кодом описывая каждую мелочь. Если какая то фича изменится Вы будете переписывать документацию.

После написания проекта:
Вы тщательно приходитесь по готовому проекту, познаёте дзен и садитесь писать доки.

P. S. Желательно аргументировать своё мнение...

Answer 1

[Максим Тимофеев]

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