"Почему люди ненавидят инструкции, но требуют их от других?"
Как часто мы возмущаемся, когда с нас требуют заполненную документацию и прочую отчётность о том, что было сделано. Как это было сделано? Способы, методы, ожидаемые последствия и т.п.
Это только на первый взгляд касается программистов и никого больше.
А как же врачи и их ставшие уже мемом "истории болезни"?
Учителя с тоннами журналов, отчётов.
Любой государственный/муниципальный служащий или инженер на работе с его десятком журналов инструктажей, обучений и контроля подчинённых - всегда бюрократ.
Почему? Потому что системность. И это не обязательно про то, чтоб вас было легко заменить или уличить в чем-то коррупционном и постыдном. Система (от греч. целое, созданное из частиц) - это всегда порядок и дисциплина. Это чёткие взаимосвязи и алгоритмы.
Когда есть понимание как проходил процесс, что от него ожидали и какие последствия предполагали - можно анализировать, строить предположения и делать выводы.
Семантически "анализ" (от греч. разделение, разборка) как раз и будет декомпозиция системы.
Инструкции к приборам или программам тоже частный случай документации. Вам говорят как пользоваться и что из этого выйдет. Ну и, конечно, как пользоваться не нужно...
😂Но мы почему-то инструкции не любим. Это как-то стыдно, что ли. Мол что я, сам с такой простой ерундой не разберусь?
будет ещё какой-то чайник мне указывать куда я буду нажимать, а куда нет
Часто слышу про ситуацию, когда кричат «Где документация?!», но сами документы пишем вроде:
// Здесь всё сломалось, но я починил. Не трогать.
Как исправить:
1. Метод «Ленивого документирования».
Когда хотя бы вкратце пишешь смысл или ожидаемый результат.
def calculate_salary(hours):
# Magic happens here (но хотя бы тип возврата указал)
return hours * 42
2. ИИ-помощник: Копируйте код в нейросеть с фразой «Объясни, как это работает, чтобы я мог это задокументировать».
И это мог бы быть выход для всех. Пусть ИИ формирует отчёты и ведёт историю действий. Но тогда все ошибки и недочёты в работе людей вылезут наружу. 🤔
Вообще автоматизация и цифровизация позволяют машине "взять на себя рутинные задачи, чтоб освободить человеку время для творческих или организационных решений". А если это не творческий человек, который по должности решений не принимает и является исполнителем? Что тогда? Думаю, мы как-то вернёмся к этому вопросу...
Интересный вопрос: если ИИ напишет документацию за нас, вспомним узнаем ли мы проделанную нами же работу лучше? (Врач пациента и его историю болезней или программист написанный код)
Играем в жизнь. Подписывайтесь, подумаем вместе.
TG канал @playkode|Яндекс Дзен
