[devel-distro] [JT] документирование коммитов

[Michael Shigorin]

On Fri, Sep 04, 2020 at 10:42:43AM +0300, Sergey V Turchin wrote:
> > Коммитов не так много, некоторые неплохо бы в master забрать, но
> > описания у них непонятные. Другие стоит заменить на непротиворечивые
> > решения. Но там опять непонятно что за задача решалась.
> Про свои я с удовольствием расскажу, если что не понятно.

Представляешь, ядро бы так разрабатывали? ;-)

Братцы, весь контекст ("зачем, почему, при какой фазе Луны"),
который мы потрудились зафиксировать в описании коммита --
бывает более ценным, чем сам дифф, потому что несёт _знание_,
а не просто реализацию.

Не ленитесь писать эти строчки, как для самих себя через год,
когда всё это вылетит из головы.

Мне как-то было очень обидно в одной редкой ситуации найти своё
письмо в рассылку и вспомнить, что я же уже эту ситуацию видел,
решил, но счёл настолько маловероятной, что не стоящей даже
наработанного хитрого xorg.conf ответным письмом туда же...

-- 
 ---- WBR, Michael Shigorin / http://altlinux.org
  ------ http://opennet.ru / http://anna-news.info