И это всё МОЁ

Традиционный подход:



  • В NEWS перечисляются важные изменения от релиза к релизу.

  • В ChangeLog перечисляются ВСЕ изменения в исходном коде.


Моё мнение по этому поводу:



  • В наше время исходным кодом в полном смысле является не столько тарбол с копией сорцов, сколько вся история сорцов, хранимая в VCS.

  • Тарболы нужны только для поставки софта в дистрибутивы, чтобы сборочной машине не приходилось тянуть файлы из VCS (что банально занимает больше времени).

  • История изменений в программе бывает не менее, а подчас и более, важна, чем статичный срез состояния кода.

  • ChangeLog — атавизм той эпохи, когда VCS не применялись повсеместно, а патчи пересылались исключительно почтой от одного разработчика другому.

  • ChangeLog не нужен, потому что есть git log или аналоги.


Имеет смысл писать только осмысленные записи в NEWS. Все, кого интересуют мелкие детали, могут прочитать git log самостоятельно. А кто не может этого сделать, тем содержимое файла ChangeLog всё равно ничего не скажет.


Ваше мнение?


P.S.


На форуме нет тегов release engineering, releng, software engineering, software life cycle или подобных, но форум настойчиво требует от меня хотя бы один тег.