История изменений
Исправление Nervous, (текущая версия) :
Все это не является документацией напрямую
Но оно же документирует. Для миграции, конечно, может быть достаточно коммента непосредственно в ее коде, в юзер мануал его выносить вряд ли стоит.
Или мы пришли к тому что и код это в общем то документацию?
В общем случае нет, ящетаю. Потому что по коду видно только то, что он делает, а не то, чего этим хотел добиться афтар. Намерения афтара есть только в его голове — и в документации.
Исправление Nervous, :
Все это не является документацией напрямую
Но оно же документирует. Для миграции, конечно, может быть достаточно коммента непосредственно в ее коде, в юзер мануал ее выносить вряд ли стоит.
Или мы пришли к тому что и код это в общем то документацию?
В общем случае нет, ящетаю. Потому что по коду видно только то, что он делает, а не то, чего этим хотел добиться афтар. Намерения афтара есть только в его голове — и в документации.
Исходная версия Nervous, :
Все это не является документацией напрямую
Но оно же документирует. Для миграции, конечно, может быть достаточно коммента непосредственно в ее коде, в юзер мануал ее выносить вряд ли стоит.
Или мы пришли к тому что и код это в общем то документацию?
В общем случае нет, ящетаю. Потому что по коду видно только то, что он делает, а не то, чего этим хотел добиться афтар.