КАТЕГОРИИ: Архитектура-(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; Просмотров: 609; Нарушение авторских прав?; Мы поможем в написании вашей работы! Нам важно ваше мнение! Был ли полезен опубликованный материал? Да | Нет |