конспект лекцій (ТСПП). Конспект лекцій з дисципліни 07 технологія створення програмних продуктів напряму 050101 Компютерні науки
 Скачать 14.87 Mb.
|
Тема 11. Документування програмних застосувань.План лекції 1. Нормативні документи по стандартизації і види стандартів. 2. Стандарти в області програмного забезпечення. 3. Загальна характеристика стану в області документування програмних засобів. 4. Єдина система програмної документації ГОСТ 19.101-77 ЕСПД. 5. Види програм і програмних документів. Самостійна робота 6.Стадії розробки. Загальні вимоги до програмних документів. Технічне завдання. 7.Опис програми. Записка пояснення. 8.Керівництво системного програміста. Вимоги до змісту і оформлення. 9.Керівництво програміста. Керівництво оператора. Опис мови. Зміст лекції Загальна характеристика процесу забезпечення якості програмного засобу. Як вже відзначалося в лекції 4, специфікація якості визначає основні орієнтири (цілі), які на усіх етапах розробки ПС так чи інакше впливають при ухваленні різних рішень на вибір відповідного варіанту. Проте, кожен примітив якості має свої особливості такого впливу, тим самим, забезпечення його наявності в ПС може зажадати своїх підходів і методів розробки ПС або окремих його частин. Крім того, відзначалася також суперечність критеріїв якості ПС і примітивів якості, що виражають їх, : хороше забезпечення одного якого-небудь примітиву якості ПС може істотно утруднити або зробити неможливим забезпечення деяких інших з цих примітивів. Тому істотна частина процесу забезпечення якості ПС складається з пошуку прийнятних компромісів. Ці компроміси частково мають бути визначені вже в специфікації якості ПС : модель якості ПС повинна конкретизувати необхідну міру присутності в ПС кожного його примітиву якості і визначати пріоритети досягнення цих мір. Забезпечення якості здійснюється в кожному технологічному процесі: прийняті в нім рішення в тій або іншій мірі чинять вплив на якість ПС в цілому. Зокрема і тому, що значна частина примітивів якості пов'язана не стільки з властивостями програм, що входять в ПС, скільки з властивостями документації. Через відмічену суперечність примітивів якості дуже важливо дотримуватися вибраних пріоритетів в їх забезпеченні. Але в усякому разі корисно дотримуватися двох загальних принципів:
Забезпечення функціональності і надійності ПС було розглянуте в попередній лекції. Нижче обговорюється забезпечення інших критеріїв якості ПС. 11.1. Нормативні документи по стандартизації і відіа стандартів.Нормативні документи по стандартизації і види стандартів В процесі стандартизації виробляються норми, правила, вимоги, характеристики, що стосуються об'єкту стандартизації, які оформляються у вигляді нормативного документу. Розглянемо різновиди нормативних документів, які рекомендуються керівництвом 2-ої Міжнародної організації по стандартизації і Міжнародній електротехнічній комісії (ИСО/МЭК), а також прийняті в державній сі-стемі стандартизації Російської Федерації (РФ). Керівництво ИСО/МЭК рекомендує: стандарти, документи технічних умов, зведення правил, регламенти (технічні регламенти), положення (мал. 1.2).  Рис.1.2. Схема різновидів нормативних документів Стандарт (від англ. standard - норма, зразок) - в широкому значенні слова зразок, еталон, модель, що приймаються за початкові для зіставлення з ними інших подібних об'єктів. Стандарт як нормативно-технічний документ встановлює комплекс норм, правил, вимог до об'єкту стандартизації. Стандарт може бути розроблений як на матеріальні предмети (продукцію, еталони, зразки речовин), так і на норми, правила, вимоги в різних областях. У переносному розумінні - шаблон, трафарет, що не містить нічого оригінального. Стандарт - це нормативний документ, розроблений на основі консенсусу, затверджений визнаним органом, спрямований на досягнення оптимальної міри впорядкування в певній області. У стандарті встановлюються для загального і багатократного використання загальні принципи, правила, характеристики, що стосуються різних видів діяльності або їх результатів. Стандарт має грунтуватися на узагальнених результатах наукових досліджень, технічних досягнень і практичного досвіду, тоді його використання принесе оптимальну вигоду для суспільства. Попередній стандарт - це тимчасовий документ, який приймається органом по стандартизації і доводиться до широкого круга потенційних споживачів, а також до тих, хто може його застосувати. Інформація, отримана в процесі використання попереднього стандарту, і відгуки про цей документ служать базою для вирішення питання про доцільність прийняття стандарту. Стандарти бувають міжнародними, регіональними, національними, адміністративно-територіальними. Вони приймаються відповідно міжнародними, регіональними, національними, територіальними органами по стандартизації. Усі ці категорії стандартів призначені для широкого круга споживачів. По існуючих нормах стандартизації стандарти періодично переглядаються для внесення змін, щоб їх вимоги відповідали рівню науково-технічного прогресу, або, згідно термінології ИСО/МЭК, стандарти мають бути "визнаними технічними правилами". Нормативний документ, у тому числі і стандарт, вважається визнаним технічним правилом, якщо він розроблений в співпраці із зацікавленими сторонами шляхом консультацій і на основі консенсусу. Вказані вище категорії стандартів називають загальнодоступними. Інші ж категорії стандартів, такі, як фірмові або галузеві, не будучи такими, можуть, проте, використовуватися і в декількох країнах згідно з існуючими там правовими нормами. У практиці термін "стандарт" може вживатися і по відношенню до еталону, зразка або опису продукту, процесу (послуги). По суті це не є принциповою помилкою, хоча еталон правильніше відносити до області метрології, а термін "стандарт" використовувати стосовно нормативного документу. Документ технічних умов (technical specification) встановлює технічні вимоги до продукції, послуги, процесу. Зазвичай в документі технічних умов мають бути вказані методи або процедури, які слід використовувати для перевірки дотримання вимог цього нормативного документу в таких ситуаціях, коли це необхідно. Зведення правило, як і попередній нормативний документ, може бути самостійним стандартом або самостійним документом, а також частиною стандарту. Зведення правил зазвичай розробляється для процесів проектування, монтажу устаткування і конструкцій, технічного обслуговування або експлуатації об'єктів, конструкцій, виробів. Технічні правила, що містяться в документі, носять рекомендаційний характер. Усі вказані вище нормативні документи є рекомендаційними. На відміну від них регламент носить обов'язковий характер. Регламент - це документ, в якому містяться обов'язкові правові норми. Окрім стандартів нормативними документами є також ПР - правила по стандартизації, Р - рекомендації по стандартизації і ТУ - технічні умови. Особлива вимога пред'являється до нормативних документів на продукцію, яка згідно з російським законодавством підлягає обов'язковій сертифікації. У них мають бути вказані ті вимоги до продукції (послузі), які підтверджуються за допомогою сертифікації, а також методи контролю (випробувань), які слід застосовувати для встановлення відповідності, правила маркіровки такої продукції і види супровідної документації. Державні стандарти розробляють на продукцію, роботи і послуги, потреби в яких носять міжгалузевий характер. Галузеві стандарти розробляються стосовно продукції певної галузі. Їх вимоги не повинні суперечити обов'язковим вимогам державних стандартів, а також правилам і нормам безпеки, встановленим для галузі. Приймають такі стандарти державні органи управління (наприклад, міністерства), які несуть відповідальність за відповідність вимог галузевих стандартів обов'язковим вимогам ГОСТ Р. Об'єктами галузевої стандартизації можуть бути: продукція, процеси і послуги, вживані в галузі; правила, що стосуються організації робіт по галузевій стандартизації; типові конструкції виробів галузевого застосування (інструменти, кріпильні деталі і тому подібне); правила метрологічного забезпечення в галузі. Діапазон вживаності галузевих стандартів обмежується підприємствами, підвідомчими державному органу управління, що прийняв цей стандарт. На добровільній основі можливе використання цих стандартів суб'єктами господарської діяльності іншого підпорядкування. Міра обов'язковості дотримання вимог стандарту галузі визначається тим підприємством, яке застосовує його, або за договором між виготівником і споживачем. Контроль за виконанням обов'язкових вимог організовує відомство, що прийняло цей стандарт. Стандарти підприємств розробляються і приймаються самими підприємствами. Об'єктами стандартизації в цьому випадку зазвичай являються складові підсистем організації і управління виробництвом, вдосконалення яких - головна мета стандартизації на цьому рівні. Крім того, стандартизація на підприємстві може зачіпати і продукцію, вироблювану цим підприємством. Тоді об'єктами стандарту підприємства будуть складові частини продукції, технологічне оснащення і інструменти, загальні технологічні норми процесу виробництва цієї продукції. Стандарти підприємств можуть містити вимоги різного роду послугам внутрішнього характеру. Закон РФ "Про стандартизацію" рекомендує використовувати стандартизацію на підприємстві для освоєння цим конкретним підприємством державних, міжнародних, регіональних стандартів, а також для регламентації вимог до сировини, напівфабрикатам і тому подібне, закуповуваним у інших організацій. Ця категорія стандартів обов'язкова для підприємства, що прийняло цей стандарт. Але якщо в договорі на розробку, виробництво, постачання продукту або надання послуг є посилання на стандарт підприємства, він стає обов'язковим для усіх суб'єктів господарської діяльності - учасників такого договору. Правила і рекомендації по стандартизації по своєму характеру відповідають нормативним документам методичного змісту. Вони можуть торкатися порядку узгодження нормативних документів, надання інформації про прийняті стандарти галузей, суспільств і інших організацій в Держстандарт РФ, створення служби по стандартизації на підприємстві, правил проведення державного контролю за дотриманням обов'язкових вимог державних стандартів і багатьох інших питань організаційного характеру. Правила і рекомендації по стандартизації розробляються, як правило, організаціями і підрозділами, підвідомчими Держстандарту РФ. Проект цих документів обговорюється із зацікавленими сторонами, затверджується і видається цими комітетами. Технічні умови розробляють підприємства і інші суб'єкти господарської діяльності у тому випадку, коли стандарт створювати недоцільно. Об'єктом ТУ може бути продукція разового постачання, що випускається малими партіями і тому подібне |