Вибір методів та засобів документування програмного забезпечення

Програмна документація – це сукупність документів, що містять відомості, необхідні для розробки, виготовлення, супроводу та експлуатації програм.

Існує чотири основні типи документації на ПЗ:

· Архітектурна/проектна – огляд програмного забезпечення, що включає опис робочого середовища та принципів, які повинні бути використані при створенні ПЗ.

· Технічна – документація на код, алгоритми, інтерфейси, АРІ.

· Користувальницька – керівництва для кінцевих користувачів, адміністраторів системи та іншого персоналу.

· Маркетингова – матеріали для реклами проекту.

Розроблюваний проект не має комерційної мети, тому не потребує маркетингової документації.

Технічна документація та керівництво для кінцевих користувачів є текстовими документами з включенням рисунків та графічних блок-схем. Для створення таких документів буде використано пакет Microsoft Office 2013, а саме MS Word для оформлення текстових документів та MS Visio для побудови блок-схем алгоритмів.

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

Word дає можливість виконати всі без вийнятку традиційні операції над текстом, передбачені в сучасній комп’ютерній технології.

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

MS Word – унікальна колекція оригінальних технологічних рішень: система готових шаблонів і стилів оформлення, прийоми створення і модифікації таблиць, функції авто тексту і авто заміни, копіювання формату, призначені для користувача панелі інструментів і т. д.

Word містить можливості технології зв’язування та впровадження об’єктів (ОLE), яка дозволяє включати в документ текстові фрагменти, таблиці, ілюстрації, підготовлені в інших додатках пакету Office. Вбудовані об’єкти можна редагувати засобами цих додатків.

Недоліки:

· Висока трудомісткість при введенні складних математичних виразів і хімічних формул.

· Низька продуктивність при наборі чорнового тексту, в порівнянні з простими редакторами.

· Деякі процедури простіше і швидше виконати в менш потужних, але більш спеціалізованих програмах.

Word не призначений для виготовлення поліграфічної продукції особливо складної структури (атласів, альбомів, журнальних обкладинок), а також для редагування високоякісних люстрацій.

MS Visio – векторний графічний редактор, призначений для роботи з діаграмами і блок-схемами для Windows.

Microsoft Visio 2007 може стати помічником в рішенні трьох основних задач: у аналізі складних даних, в графічному представленні даних і в обміні цими даними між користувачами.

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

Фігури є основним, але не єдиним способом для представлення даних в Visio. Окрім них можна також використовувати текст і числові дані, графічні елементи і форматування кольором.

Найзручніший спосіб початку роботи з Visio – створити документ на основі шаблону. При завантаженні шаблону на область завдань «Фігури» завантажуються в ті категорії графічних елементів, які можуть знадобитися в процесі створення діаграми, плану або карти вибраного типу.