Зачем поддерживать традиционный подробный журнал изменений в современном мире (с SVN , Mercurial, Git)?

Подробная запись в журнале изменений обычно сообщает, кто, когда и какая функция была изменена и почему это изменение было сделано.

И это для каждой отдельной функции в дереве исходного кода!

Насколько я понимаю, журнал изменений появился в прошлом, когда были нет хорошей VCS.

Таким образом, традиционный журнал изменений не нужен вообще, так как вы можете получить все это из:

  $ svn log .
  $ hg log .
  $ git log .
  $ bzr log .

Только одна возможная потребность в журнале изменений для краткого обзора между версиями продукта и предназначена только для пользователя (например, когда новые версия приходит, разработчик готовит журнал изменений, описывающий заметные / видимые изменения).

Или я ошибаюсь?

Из http://autotoolset.sourceforge.net/tutorial.html#SEC45 :

The ChangeLog file: Use this file to record all the changes that you make to your
source code. If your source code is distributed among many subdirectories,
and there is reason enough to think of the contents of the subdirectories
as different subpackages,then please maintain a separate `ChangeLog'
file for each subdirectory.

Выглядите архаично и догматично. Журнал изменений, требуемый автоинструментами и "стандартами кодирования GNU".

Исходный код GNU Emacs содержит множество огромных журналов изменений (многие из которых разбиты на несколько частей):

  $ find emacs-22.3 -name "ChangeLog*" | xargs cat | wc -c
13605747

Я могу получить сводный журнал из репозитория Emacs bzr в течение примерно 1 минуты и выполнять поиск по нему вместо поиска каждого отдельного журнала изменений и с помощью современных инструментов, таких как Emacs VC или Tortoise SVN / HG немедленно получить разницу для изменений.

ОБНОВЛЕНИЕ Обоснование использования ChengeLog исходит из тупости системы управления обслуживанием RCS / CVS. Проверьте http://www.red-bean.com/cvs2cl/changelogs.html раздел «Журналы изменений и журнал CVS». Все современные VCS предоставляют / разрешают критику в этой статье в CVS.

Также существует множество sctipts, которые преобразуют вашу историю VCS в стиль журнала изменений. Итак, отклоните все ваши журнал изменений .

Если вы хотите предоставить ориентированную на пользователя информацию о функциях / обратной совместимости / и т. Д. Между версиями, используйте файл NEWS: http: / /www.gnu. org / prep / standard / html_node / NEWS-File.html

6
задан gavenkoa 14 July 2011 в 15:10
поделиться