Студопедия

КАТЕГОРИИ:


Архитектура-(3434)Астрономия-(809)Биология-(7483)Биотехнологии-(1457)Военное дело-(14632)Высокие технологии-(1363)География-(913)Геология-(1438)Государство-(451)Демография-(1065)Дом-(47672)Журналистика и СМИ-(912)Изобретательство-(14524)Иностранные языки-(4268)Информатика-(17799)Искусство-(1338)История-(13644)Компьютеры-(11121)Косметика-(55)Кулинария-(373)Культура-(8427)Лингвистика-(374)Литература-(1642)Маркетинг-(23702)Математика-(16968)Машиностроение-(1700)Медицина-(12668)Менеджмент-(24684)Механика-(15423)Науковедение-(506)Образование-(11852)Охрана труда-(3308)Педагогика-(5571)Полиграфия-(1312)Политика-(7869)Право-(5454)Приборостроение-(1369)Программирование-(2801)Производство-(97182)Промышленность-(8706)Психология-(18388)Религия-(3217)Связь-(10668)Сельское хозяйство-(299)Социология-(6455)Спорт-(42831)Строительство-(4793)Торговля-(5050)Транспорт-(2929)Туризм-(1568)Физика-(3942)Философия-(17015)Финансы-(26596)Химия-(22929)Экология-(12095)Экономика-(9961)Электроника-(8441)Электротехника-(4623)Энергетика-(12629)Юриспруденция-(1492)Ядерная техника-(1748)

Записка пояснення




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

Зміст записки пояснення за стандартом (ГОСТ 19.404-79) повинен включати наступні розділи:

· вступ;

· призначення і сфера застосування;

· технічні характеристики;

· очікувані техніко-економічні показники;

· джерела, використовувані при розробці.

У розділі Введення вказують найменування програми і документу, на підставі якого ведеться розробка.

У розділі Призначення і сфера застосування вказують призначення програми і дають коротку характеристику сфери застосування.

Розділ Технічні характеристики повинен містити наступні підрозділи:

· постановку завдання, опис вживаних математичних методів і допущень і обмежень, пов'язаних з вибраним математичним апаратом;

· опис алгоритмів і функціонування програми з обгрунтуванням прийнятих рішень;

· опис і обгрунтування вибору способу організації вхідних і вихідних даних;

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

У розділі Очікувані техніко-економічні показники вказують техніко-економічні показники, що обгрунтовують перевагу вибраного варіанту технічного рішення.

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

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

 

11.8.Керівництво системного програміста. Вимоги до змісту і оформлення.

Посібник користувача

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

Складання документації для користувачів має свої особливості, пов'язані з тим, що користувач, як правило, не є професіоналом в області розробки програмного забезпечення. У книзі С. Дж. Гримм дані рекомендації по написанню подібної програмної документації:

· враховуйте інтереси користувачів - керівництво повинне містити усі інструкції, необхідні користувачеві;

· викладайте ясно, використовуйте короткі пропозиції;

· уникайте технічного жаргону і вузькоспеціальної термінології, якщо все ж необхідно використовувати деякі терміни, то їх слід пояснити;

· будьте точні і раціональні - довге і заплутане керівництво зазвичай ніхто не читає, наприклад, краще привести малюнок форми, чим довго її описувати.

Посібник користувача, як правило, містить наступні розділи:

· загальні відомості про програмний продукт;

· опис установки;

· опис запуску;

· інструкції по роботі (чи опис призначеного для користувача інтерфейсу);

· повідомлення користувача.

Розділ Загальні відомості про програму зазвичай містить найменування програмного продукту, короткий опис його функцій, реалізованих методів і можливих сфер застосування.

Розділ Установка зазвичай містить детальний опис дій з установки програмного продукту і повідомлень, які при цьому можуть бути отримані.

У розділі Запуск, як правило, описані дії із запуску програмного продукту і повідомлень, які при цьому можуть бути отримані.

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

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

 




Поделиться с друзьями:


Дата добавления: 2014-01-04; Просмотров: 574; Нарушение авторских прав?; Мы поможем в написании вашей работы!


Нам важно ваше мнение! Был ли полезен опубликованный материал? Да | Нет



studopedia.su - Студопедия (2013 - 2024) год. Все материалы представленные на сайте исключительно с целью ознакомления читателями и не преследуют коммерческих целей или нарушение авторских прав! Последнее добавление




Генерация страницы за: 0.01 сек.