Руководство программиста
Если кроме использования и настройки, программное обеспечение предоставляет возможность написания, редактирования или использования программного кода. Какой документ необходим в этом случае?
Назначение руководства программиста
Руководство программиста относится к эксплуатационно-технической документации и требуется в тех случаях, когда система тем или иным образом предоставляет возможность написания, редактирования или использования программного кода. Примерами могут служить:
- библиотека функций;
- платформа или среда для разработки ПО;
- ПО с открытым кодом.
Документ должен предоставлять всю необходимую информацию для того, чтобы разработчик мог воспользоваться возможностями системы. Для решения этой задачи содержание документа может включать в себя:
- назначение, структуру входных и выходных данных программных функций;
- возможности по созданию программного кода, особенности его интерпретации и компиляции;
- синтаксические особенности используемого языка программирования;
- возможные правила и ограничения при работе с программным кодом;
- различные инструкции по работе с программой.
Список возможных тем этим не ограничивается, все зависит от особенностей конкретной системы. Надо сказать, что руководство программиста бывает очень полезно и для разработчиков системы, являясь справочником по текущей реализации логики работы ПО.
Состав типового руководства программиста
В соответствии с требованиями ГОСТ руководство программиста должно содержать следующие разделы:
- Назначение и условия применения программы, где указывают область применения ПО и технические требования, необходимые для его работы.
- Характеристика программы, где описывают режим работы программы, показатели скорости ее работы и другие важные для использования характеристики.
- Обращение к программе, где указывают способы и параметры запуска программы;
- Входные и выходные данные, где описывают формат, способ организации и другие требования к входным и выходным данным;
-
Сообщения, где приводят тексты сообщений, выдаваемых программой в различных ситуациях и действия, которые необходимо при этом предпринять.
Различные примеры, иллюстрации и таблицы целесообразно приводить в приложениях к документу.
Стандарты для руководства программиста
ГОСТы регламентируют и этот документ, в данном случае это ГОСТ 19.504. В соответствии с ним определяется структура и содержание Руководства программиста.
Заключение
Работа по созданию руководства программиста требует высокой квалификации специалиста и знаний в области программирования, однако, для профессиональных разработчиков такая работа обычно представляется скучной и нудной, к тому же, требует умения грамотно формулировать и доступно доносить материал. Специалисты ТехРайтКонсалт обладают большим опытом в обеих областях, что позволяет нам создавать документы по доступной цене и точно в срок!
Вас также может заинтересовать: