Конечно, если вы пишете hello world, то можно остановиться на паре строчек кода. Но в реальной жизни одного кода бывает мало. Для того чтобы с программой можно было работать в будущем, и как-то ее поддерживать нужна документация. Без документации программу не смогут использовать другие и если программа будет давать сбои, просто выпилят ее из системы как ненадежное легаси решение. Сейчас существуют решения для автоматического создания документации из аннотаций в коде. В некоторых языках документация создаётся из комментариев к функциям. Можно попробовать создавать документацию с помощью LLM (если у вас есть подобный опыт поделитесь). Сложные системы состоят из множества программ. Иногда они выходят из строя, но этого не заметно. И тут возникает такой термин как обсервабилити. Обсервабилити состоит из трёх аспектов. Это: логгирование, трассировки, мониторинг. Мониторинг позволяет увидеть что что то пошло не так и предпринять действия до того как неполадку заметит пользователь. Логи и трейсы позволяют понять где случилась проблема. Для того чтобы можно было наблюдать за поведением системы, в программе нужно предусмотреть специальные интерфейсы. Так же нужно обеспечить вывод метрик. Желательно рассказать про это в документации. Для сбора логов, трейсов, и мониторинга требуется установка специального ПО. Софт это не только код, который решает поставленную задачу. Так же следует озаботиться докуументацией и предоставить возможность мониторинга. Без документации и возможности мониторинга софт неполноценный.