документация Софтуер

Софтуер документация - печатни ръководства на потребителя, интерактивна работа (оперативна) документация и помощен текст, който описва как да използвате софтуерния продукт [1].

елемент документ - документът: Информацията за обекта, предназначени за конкретна аудитория, поставена на специално среда (например, в книгата на диска, бърза справка карта) във формат [1].

Програма документ - документ, съдържащ в зависимост от целта на данни, необходими за проектиране, производство, експлоатация, програми за поддръжка или софтуерни инструменти [2].

Има четири основни типа документация за софтуер:

• архитектура / дизайн - преглед на софтуера, включително и работната среда, както и описание на принципите, които трябва да се използва при създаването на софтуер
• технически - документация за кода. алгоритми. интерфейси, API
• потребител - ръководство за крайните потребители, системни администратори и други служители
• маркетинг

Архитектура / конструкторска документация

Проектна документация обикновено описва продукта като цяло. Без да се описва как се използва нещо, то вероятно отговаря на въпроса "защо така." Така например, в документацията по проекта програмист може да се опише обосновка защо тези структури са организирани по този начин. Описва причините, поради които всеки клас има за цел по определен начин, моделите се открояват. в някои случаи, дори и като се има предвид идеята за това как тя ще бъде възможно да се извърши подобрения в бъдеще. Нищо от това не е включена в техническата документация или ръководство, но това е наистина важно за проекта.

При създаване на програма, само един код. обикновено не е достатъчно. Трябва да се има предвид някакъв текст, описващ различни аспекти на това, което прави кода. Тази документация често е включена директно в изходния код или доставени с него.

Тази документация е силно изразен технически характер и се използва предимно за откриване и описване на API. структури от данни и алгоритми.

документация за потребителя

За разлика от техническата документация, фокусирани върху кода и как работи, само документацията за потребителя описва как да използвате програмата.

Ако продуктът е софтуерна библиотека. потребителска документация и документация за код са много близки, почти равностойни. Но като цяло, не е така.

Обикновено документацията за потребителя е водач на потребителя. която описва всяка функция на програмата, както и стъпки, които можете да следвате, за да използвате тази функция. Добър потребителска документация отива една стъпка по-далеч и осигурява инструкции какво да правят в случай на проблеми. Важно е, че документацията не е подвеждащо и е от значение. Ръководството трябва да има ясна структура; много полезно, ако има индекс хоризонтален субект. Логическата последователност и простота също са важни.

Има три подхода за организиране на документацията за потребителя. Ръководство за начинаещи (инж. Tutorial), най-полезно за нови потребители, постоянно се преследва от редица стъпки, които се използват за извършване на каквито и да било типични задачи. Тематичен подход, при който всяка глава на ръководството е посветен на определена тема някои по-подходящи за подобряване на потребителя. В последния, третия подход, екипът или задача са организирани в азбучен указател - често добре приети от напреднали потребители, които са запознати с това, което търсите. оплаквания от потребители обикновено са свързани с факта, че документацията обхваща само един от тези подходи, и затова е подходящ за само един клас потребители.

В много случаи, разработчици на софтуер ограничен набор от документация за потребителя е само в помощната система (инж. Онлайн помощ), съдържащ информация за справка относно команди или елементи от менюто. Работата по подготовката на нови потребители и подкрепата на подобряване на потребителя се предава на частните издатели, често предоставя значителна помощ на разработчиците.

маркетинг документация

• възбуди интерес към продукта от страна на потенциалните потребители
• ги информира за това, което прави продукта, така че да отговарят на очакванията им с това, което те ще получат
• за да обясни позицията на продукта в сравнение с конкурентните решения

Един добър маркетинг добри практики - един лозунг - обикновен закачливите фрази, които да представят на факта, че искаме да предадем на потребителя, както и характеризиращи чувство. което създава продукт.

Това често се случва, че кутията на продукта и други маркетингови материали дават по-ясна представа за възможностите и начините за използване на програмата, отколкото нещо друго.