----------------------------------------------------------------------------------
@MSGID: 2:5055/182 1cb932fc
@PID: jNode ver. 1.5
@TID: jNode ver. 1.5
@CHRS: CP866 2
**Раньше трава была зеленее**
Время воскресных очешуительных историй.
[Вообще, в релиз ноутах должна быть совсем не история
коммитов.](
https://habr.com/ru/articles/770432/)
Вы посмотрите на подобные документы, написанные до тех времен, когда
чужие стеной пошли вайтишечку. Просто для интереса.
Во-первых, релиз ноуты все же пишутся ручками. В них пишут
верхнеуровневые изменения - что поменялось в архитектуре, в функционале - причем
понятным, человеческим языком. Как вы думаете, когда у вас закрытый код, к
примеру - ну, коммерческий - что дадут ваши описания коммитов простому
смертному? А читают релиз ноуты совсем не архитекторы, это часть комплекта
открытой документации. На минуточку.
Во-вторых, а вам не кажется, что генеративная документация - это и
не документация вовсе, а работа на отъебись, что называется? Да и не
работа это вовсе. И гордиться тут ну вообще нечем.
Вот сами подумайте. Ченджлоги у вас - история коммитов, ничего не
говорящая никому, кроме девов. Релиз ноуты - описания коммитов, ничего не
говорящие никому, кроме девов.
Кому нужна такая работа? Тимлиду? KPI считать?
Ну и?
Все знают, что я люблю приводить в пример документацию китов -
написанную инженерами для инженеров и техписами для пользователей. Подробную,
исчерпывающую, вменяемую. Я и сам так же стараюсь ее писать. Ручками. Вдумчиво. С
расчетом на то, что ее будут читать.
И что? Знаете, что мне на днях заявили? "Твоя документация выглядит
как будто ее студент писал".
А как теперь надо? В виде комиксов, что ли? Серьезно, Карл? Выросло
поколение, которое традиционную документацию видит как набор иероглифов, потому
что дислексия? Ну так с такой инвалидностью вали ВОН из индустрии,
которая, тащемта, все еще считается инженерией и заточена под тексты.
Комиксов рисовать не буду принципиально. И генерировать такую важную
часть ПО не буду тем более.
PS. __Я понимаю, что День Дегенерата настал и он теперь с нами
навсегда. Но - нет, Гэри. Нет. Учитесь читать и понимать написанное. И связно
излагать информацию. В противном случае - Эверест недоставленных пицц, он ждет
своих героев.__
http://fido.ortoped.org.ru/photo_2023-10-28_08-00-07.jpg
--- hssergey station
* Origin: jNode ver. 1.5 (2:5055/182)
SEEN-BY: 301/1 460/58 4500/1 5001/100 5005/49
5015/255 5019/40 5020/715 848
SEEN-BY: 5020/1042 4441 12000 5030/49 1081 5055/182
5058/104 5061/133
SEEN-BY: 5083/444
@PATH: 5055/182 5020/1042 4441