With software being all around us, it is surprising how little the documentation of it has developed during the last decades. Software system documentation is however most critical during maintenance tasks, where tremendous amounts of time are spend understanding the software and its documentation, before the actual maintenance work can start. This paper gives a status of current documentation practices as well as a view on its quality. The purpose of this paper is to create a discussion about those practices to foster ideas for the future.

Розглянуто проблематику та шляхи вирішення проблеми недостатньої кількості документації, що створюється для програмного забезпечення протягом останніх десятиліть. Документація для систем програмного забезпечення є важливим фактором у процесі технічного обслуговування, коли величезна кількість часу витрачається в спробах зрозуміти програмне забезпечення і його документацію до фактичного старту роботи. Розглянуто статус існуючої практики документування, а також проведено огляд якості документації. Метою статті є обговорення існуючих практик документування для сприяння розгорнутої дискусії в майбутньому.

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