Свои доработки надо документировать⁠⁠

Доброе время года, дорогие пикабушники.

Писал комментарий к посту https://pikabu.ru/story/na_temu_soderzhaniya_spetsialistov_5... , но понял что мой комментарий перерастает в целый пост.

Я вот не понимаю, неужели нельзя было задокументировать свои изменения? Сообщить о них начальству (начальнику отдела хотя бы)?

Т.е. создать вордовский файлик и в нем своими словами записать "что, где, зачем". Если нет компа, взять листок бумаги и написать от руки.

И при увольнении передать это руководителю.

Вы бы сохранили кучу времени себе и другим людям.

Приведу пример из своей практики.

Работал я в IT-отделе одной большой торговой компании.

Учет товара на складах велся с помощью терминалов сбора данных (далее ТСД, это портативный ПК со сканером штрих кода).

И была проблема, из-за того что почти все ТСД были старыми, они периодически начинали глючить\зависать и их приходилось перенастраивать заново. А это большие потери времени, т.к. сначала нужно было составить заявку, а потом ждать когда сотрудник техподдержки до неё доберется.

Я сказал руководителю моей группы, что могу написать скрипты, которые будут настраивать ТСД автоматически. Он одобрил эту идею.

Я посидел в гугле пару дней и написал нужные скрипты. Далее я их проверил, доработал и начал развертывать на всех ТСД.

Теперь когда ТСД начинал глючить\зависать, работнику склада достаточно было перезагрузить его. И затем продолжить работу.

Когда работа по развертыванию была завершена, я написал подробную инструкцию, где все скрипты разъяснялись буквально построчно.

Начальник группы был в курсе всего этого. И даже выбил мне небольшую премию.

Спустя некоторое время я уволился из этой компании.

По поводу моих скриптов мне звонили всего два раза. И оба раза разговор был примерно такой (Я - это я, К - это бывший коллега):

К: Kreeme, привет.

Я: Привет.

К: Слушай, можешь подсказать по поводу твоих скриптов на ТСД?

Я: Я там инструкцию писал, посмотри на сервере в моей папке.

К: Ок, спасибо, гляну.

И все довольны и счастливы.

Вывод.

Доработка и улучшение доверенной тебе техники - это всегда хорошо.

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

По этому надо документировать все свои доработки (хоть на клочке бумаги). И надо помнить, что документация пишется в первую очередь для себя.

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