24. Документація, що створюється в процесі розробки програмних засобів. Документи управління розробкою пз. Документи, що входять до складу пз.

При розробці ПЗ створюється великий об'єм різноманітної документації. Вона необхідна як засіб передачі інформації між розробниками ПЗ, як засіб управління розробкою ПЗ і як засіб передачі користувачам інформації, необхідної для застосування і супроводу ПЗ. На створення цієї документації доводиться велика частка вартості ПЗ.

Цю документацію можна розбити на дві групи:

- Документи управління розробкою ПЗ.

- Документи, що входять до складу ПЗ.

Документи управління розробкою ПЗ (process documentation), протоколюють процеси розробки і супроводу ПЗ, забезпечуючи зв'язки усередині колективу розробників і між колективом розробників і менеджерами (managers) - особами, керівниками розробкою. Ці документи можуть бути наступних типів:

- Плани, оцінки, розклади. Ці документи створюються менеджерами для прогнозування і управління процесами розробки і супроводу.

- Звіти про використання ресурсів в процесі розробки. Створюються менеджерами.

- Стандарти. Ці документи наказують розробникам, яким принципам, правилам, угодам вони повинні слідувати в процесі розробки ПЗ. Ці стандарти можуть бути як міжнародними або національними, так і спеціально створеними для організації, в якій ведеться розробка даного ПЗ.

- Робочі документи. Це основні технічні документи, що забезпечують зв'язок між розробниками. Вони містять фіксацію ідей і проблем, що виникають в процесі розробки, опис використовуваних стратегій і підходів, а також робочі (тимчасові) версії документів, які повинні увійти в ПЗ.

- Замітки і листування. Ці документи фіксують різні деталі взаємодії між менеджерами і розробниками.

Документи, що входять до складу ПЗ (product documentation), описують програми ПЗ як з погляду їх застосування користувачами, так і з погляду їх розробників і супровідників (відповідно до призначення ПЗ). Тут слід зазначити, що ці документи використовуватимуться не тільки на стадії експлуатації ПЗ (у її фазах застосування і супроводу), але і на стадії розробки для управління процесом розробки (разом з робочими документами) - в усякому разі вони мають бути перевірені (протестовані) на відповідність програмам ПЗ. Ці документи утворюють два комплекти з різним призначенням:

- Призначена для користувача документація ПЗ (П-документация).

- Документація по супроводу ПЗ (С-документация).

25. Призначена для користувача документація.

Призначена для користувача документація ПЗ (user documentation) пояснює користувачам, як вони повинні діяти, щоб застосувати дане ПЗ. Вона необхідна, якщо ПЗ припускає яку-небудь взаємодію з користувачами. До такої документації відносяться документи, якими керується користувач при інсталяциі ПЗ (при установці ПЗ з відповідним настроюванням на середовище застосування ПЗ), при застосуванні ПЗ для вирішення своїх завдань і при управлінні ПЗ (наприклад, коли дане ПЗ взаємодіє з іншими системами). Ці документи частково піднімають питання супроводу ПЗ, але не стосуються питань, пов'язаних з модифікацією програм.

У зв'язку з цим слід розрізняти дві категорії користувачів ПЗ: ординарних користувачів ПЗ і адміністраторів ПЗ. Ординарний користувач ПЗ (end-user) використовує ПЗ для вирішення своїх завдань (у своїй наочній області). Це може бути інженер, що проектує технічний пристрій, або касир, що продає залізничні квитки за допомогою ПЗ. Він може і не знати багатьох деталей роботи комп'ютера або принципів програмування. Адміністратор ПЗ (system administrator) управляє використанням ПЗ ординарними користувачами і здійснює супровід ПЗ, не пов'язаний з модифікацією програм. Наприклад, він може регулювати права доступу до ПЗ між ординарними користувачами, підтримувати зв'язок з постачальниками ПЗ або виконувати певні дії, щоб підтримувати ПЗ в робочому стані, якщо воно включене як частина в іншу систему.

Склад призначеної для користувача документації залежить від аудиторій користувачів, на яких орієнтоване дане ПЗ, і від режиму використання документів. Під аудиторією тут розуміється контингент користувачів ПЗ, у якого є необхідність в певній призначеній для користувача документації ПЗ [13.2]. Вдалий призначений для користувача документ істотно залежить від точного визначення аудиторії, для якої він призначений. Призначена для користувача документація повинна містити інформацію, необхідну для кожної аудиторії. Під режимом використання документа розуміється спосіб, що визначає, яким чином використовується цей документ. Зазвичай користувачеві достатньо великих програмних систем потрібно або документи для вивчення ПЗ (використання у вигляді інструкції), або для уточнення деякої інформації (використання у вигляді довідника).

Можна вважати за типовий наступний склад призначеної для користувача документації для достатньо великих ПЗ:

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

- Керівництво по інсталяциі ПЗ. Призначено для системних адміністраторів. Він повинен детально наказувати, як встановлювати системи в конкретному середовищі. Він повинен містити опис машинно-прочитуваного носія, на якому поставляється ПЗ, файли, представляючі ПЗ, і вимоги до мінімальної конфігурації апаратури.

- Інструкція по застосуванню ПЗ. Призначена для ординарних користувачів. Містить необхідну інформацію по застосуванню ПЗ, організовану у формі зручної для її вивчення.

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

- Керівництво по управлінню ПЗ. Призначено для системних адміністраторів. Воно повинне описувати повідомлення, що генеруються, коли ПЗ взаємодіє з іншими системами, і як реагувати на ці повідомлення. Крім того, якщо ПЗ використовує системну апаратуру, цей документ може пояснювати, як супроводжувати цю апаратуру.

Розробка призначеної для користувача документації починається відразу після створення зовнішнього опису. Якість цієї документації може істотно визначати успіх ПЗ. Вона має бути достатньо проста і зручна для користувача (інакше це ПЗ, взагалі, не варто було створювати). Тому, хоча чорнові варіанти (накидання) призначених для користувача документів створюються основними розробниками ПЗ, до створення їх остаточних варіантів часто притягуються професійні технічні письменники. Крім того, для забезпечення якості призначеної для користувача документації розроблений ряд стандартів (див. гл.1.), в яких наказує порядок розробки цієї документації, формулюються вимоги до кожного виду призначених для користувача документів і визначаються їх структура і зміст .