Створення програмної документації - важливий етап, так як користувач починає своє знайомство з програмним продуктом саме з документації. Для чого призначений програмний продукт. як встановити програмний продукт, як почати з ним працювати - ось одні з перших питань, на які повинна відповідати програмна документація (Installation Guide, Getting Started). Складанням програмної документації зазвичай займаються спеціальні люди - технічні письменники (іноді програмну документацію пишуть самі програмісти або аналітики). Цей етап є найнеприємнішим і важким в програмістської роботі. На жаль, зазвичай цього або не вчать зовсім, або в кращому випадку не звертають на якість одержуваних документів належної уваги. Проте володіння цим мистецтвом є одним з найважливіших факторів, що визначають якість програміста.
Грамотно складений (точніше, створений) пакет програмної документації позбавить вас від багатьох неприємностей. Зокрема, позбутися від настирливих питань і необгрунтованих претензій можна, просто відіславши користувача до документації. Це стосується перш за все найважливішого документа - Технічного завдання. Можна нагадати про багатомільйонний позов до компанії IBM, який пред'явило одне велике видавництво, що не задоволене якістю обчислювальної техніки і програмного забезпечення. IBM суд виграла тільки завдяки тому, що пред'явила підписана обома сторонами Технічне завдання. Було це давно, ще в 70-х роках 20 століття, проте суті справи це не змінює. На Заході важливість програмної документації зрозуміли давно, разом з програмним забезпеченням поставляється цілий пакет документації.
Коли програміст-розробник отримує в тій чи іншій формі завдання на програмування, перед ним, перед керівником проекту і перед всією проектною групою постають питання:
• Що має бути зроблено, крім власне програми?
• Що і як має бути оформлено у вигляді документації?
• Що передавати користувачам, а що - службі супроводу?
• Як управляти всім цим процесом?
• Що має входити в саме завдання на програмування?
На ці та інші питання колись відповідали державні стандарти на програмну документацію - комплекс стандартів 19-й серії ГОСТ ЕСПД. Але вже тоді у програмістів була маса претензій до цих стандартів. Щось потрібно дублювати в документації багато разів (як виявилося - невиправдано), а багато чого не було передбачено, як, наприклад, відображення специфіки документування програм, які працюють з інтегрованою базою даних.
Минуло багато років, програмування відбувається в середовищі абсолютно нових технологій, багато програмістів, працюючи в стилі drag-and-drop, можуть роками не бачити текстів своїх програм. Це не означає, що зникла необхідність в їх документування. Питання про наявність хоч якоїсь системи, яка регламентує цю сторону створення програмних засобів, продовжують ставити постійно.