Създаване на софтуер документация - важен етап, тъй като потребителят започва запознал с него със софтуера е документация. Какво е софтуерен продукт. как да инсталирате софтуера, можете да започнете да работите с него - това е един от първите въпроси, които трябва да отговарят на документацията на програмата (Ръководство за инсталиране, Първи стъпки). Рисуване документация програма обикновено се занимава с специални хора - технически писатели (а понякога и софтуер документация се пишат програмисти или анализатори). Този етап е най-неприятна и тежка работа в програмист. За съжаление, това е обикновено или не са научени на всички, или в най-добрия, не се обръща достатъчно внимание на качеството на документите. Независимо от това, притежание на това изкуство е един от най-важните фактори, определящи качеството на програмист.
Компетентно съставен (или по-скоро е създаден) софтуерен пакет документация ще ви спаси от много неприятности. По-специално, за да се отървете от неприятните проблеми и необосновани претенции, като просто изпращане на потребителска документация. Това се отнася преди всичко до най-важният документ - техническото задание. Тя може да се припомни за милиони долари дело срещу компанията IBM, който подава една голяма издателска къща, не е доволен от качеството на компютърно оборудване и софтуер. IBM спечели съдебно само от факта, че и двете страни подаване на подписано техническо задание. Това беше много отдавна, още през 70-те години на 20-ти век, но всъщност това не се променя. На Запад осъзнахме значението на софтуер документация за дълго време, заедно със софтуера идва комплект документи.
Когато един програмист-разработчик получава в една или друга форма на програмираните задачи, пред него, на ръководителя на проекта, както и на целия екип на проекта, тогава възниква въпросът:
• Какво трябва да се направи, но реалната програма?
• Какво и как трябва да бъде под формата на документация?
• Какъв трансфер на потребителите, както и че - подкрепата на услугата?
• Как да управляваме целия процес?
• Какво трябва да се включи в себе си задача в програмирането?
На тези и други въпроси, след като се срещна държавните стандарти за документиране програма - набор от 19 стандарти ГОСТ Серия ЕПСО. Но дори и тогава, разработчиците са имали много претенции към тези стандарти. Нещо необходимо да се дублира документацията отново и отново (както се оказа - ненужно), но много от тях не са били предоставени, като отражение на програми, които документират със спецификата на работа с интегрирана база данни.
Много години са минали, програмирането се извършва в среда, напълно нови технологии, много програмисти, които работят в стила на плъзгане и пускане, не може да види годините на текстовете на своите програми. Това не означава, че вече не е необходимо в тяхната документация. Въпроси относно присъствието на поне част от системата, която регулира този аспект от създаването на софтуерни инструменти продължават да настроите времето.
Свързани статии