Самая обычная бумажная книга учета - это пока лучший инструмент фиксации проектных изменений из всех, с которыми я сталкивался за свои более чем 20 лет стажа в ИТ!

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

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

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

===

Только один раз все было ясно и понятно! Тогда я обслуживал бухгалтерские досовскими программами на Foxpro и у нас был один клиент, к которому за Киев нужно было ехать на автобусе. Бухгалтерия там состояла из классических Марьивановних, которые только-только сняли меховые шапки и едва начали экспериментировать с новыми понтами в виде накладных ногтей и выщипанных бровей. Рабочие машины были с маленькими пузатыми мониторами и клацающими механическими клавиатурами, а для печати - огромный матричный принтер. А еще нужно было каждый визит фиксировать в специальной книге учета модернизации ПО.

Да, это та самая волшебная книга!

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

===

Согласен - немного слукавил 😅

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

Вся магия там была не в инструменте, а в процессе!

За мою карьеру, это был единственный клиент, который настолько серьёзно подошел к документированию и включил требование наличия детального описания визита в процесс согласования его оплаты. Это вам не традиционные для таких случаях акты работ и листы учета рабочего времени, которые практически никто не читает, а потому которые по факту просто бесполезные бумажки. Тут заказчик точно знал что ему нужно и потребовал отчетность в удобном и полезном для него виде в рамках актуальных технических ограничений. Не удивлюсь, если сейчас у них уже Джира с Конфлюенсом.