Смесь французского с нижегородским
Почему бы нет? Взять лучшее, что можно «высосать» из ГОСТ 19, - обобщенную структуру руководства пользователя, добавить к ней немногочисленные толковые рекомендации из IEEE Std 1063-2001 и разбавить неисчерпаемой стилистической культурой и ресурсами языка из манифеста Кагарлицкого? Придать смеси стройный строгий вид, сформировать очередной учебно-тренировочный документ с подробными комментариями? А что делать, если ни один из перечисленных выше трех источников и трех составных частей в отдельности не способны дать ответы на все поставленные вопросы?
Об этом - в очередной статье.
Таблица соответствия ГОСТ 19 и IEEE Std 1063-2001
ГОСТ 19 | IEEE Std 1063-2001 |
Аннотация | Introduction |
The introduction shall describe the intended audience, scope, and purpose for the document and include a brief overview of the software purpose, functions, and operating environment | |
- Назначение документа | purpose for the document (Introduction) |
- Краткое изложение основной части документа | scope (Introduction) |
Общие сведения о программе | |
- Обозначение и наименование программы | |
- Языки программирования, на которых написана программа | |
- Сведения о назначении программы | brief overview of the software purpose (Introduction) |
-- Информация, достаточная для понимания функций программы и ее эксплуатации | |
--- Возможности программы | |
--- Классы решаемых задач | |
---- Описание задач | |
---- Методы решения задач | Documentation shall relate each documented function to the overall process or tasks |
--- Функции, выполняемые программой | brief overview of the software ... functions (Introduction) |
-- Описание основных характеристик и особенностей программы | |
--- Временные характеристики | |
--- Режим работы | |
--- Средства контроля правильности выполнения и самовосстанавливаемости программы | |
-- Ограничения области применения программы | |
--- Сведения о функциональных ограничениях на применение | |
Условия применения программы | If different versions of the software are available for different operating environments, the title page should specify the applicable operating environment(s), including version(s) of hardware, communications, and operating system(s) (4.3. Content of identification data) |
- Условия, необходимые для выполнения программы | |
-- Сведения о технических и программных средствах, обеспечивающих выполнение программы | Documentation for the hardware and software environment (4.11 Information on related information sources) |
--- Требования к техническим средствам | |
---- Типы ЭВМ, устройств, используемые при работе программы | |
---- Объем оперативной памяти | |
---- Минимальный и (или) максимальный состав аппаратурных и программных средств | |
---- Требования к составу и параметрам периферийных устройств | |
--- Программное обеспечение, необходимое для функционирование программы | brief overview of the ... operating environment (Introduction) |
---- Требования к программному обеспечению | |
---- Требования к другим программам | |
--- Требования и условия организационного, технического и технологического характера | |
Описание логической структуры | |
- Алгоритм программы | algorithms (4.5 Concept of operations) |
- Используемые методы | using such methods as a visual or verbal overview of the process or workflow (4.5 Concept of operations) |
- Сведения о структуре программы | |
- Сведения о составных частях программы | |
- Описание функций составных частей | |
- Сведения о связях между составными частями программы | |
- Сведения о связях с другими программами | |
Сведения о входных и выходных данных | |
- Общие характеристики входной и выходной информации | |
- Сведения о входных данных | |
-- Характер, организация и предварительная подготовка входных данных | |
- Сведения о выходных данных | |
-- Характер и организация выходных данных | |
-- Формат, описание и способ кодирования выходных данных | |
- Описание кодирования информации | |
Настройка программы | Identification of technical or administrative activities that must be done before starting the task (4.7 Information for procedures and tutorials) |
- Описание действий по настройке программы | |
-- Настройка на состав технических средств | |
-- Выбор функций | |
-- Поясняющие примеры | |
Проверка программы | |
- Описание способов проверки работоспособности программы | |
-- Контрольные примеры | Examples should illustrate the use of commands (4.8 Information on software commands) |
-- Методы прогона | |
-- Результаты | |
Выполнение программы | |
- Загрузка программы - Способ вызова программы с соответствующего носителя данных - Описание процедур вызова программы | Software installation and de-installation, if performed by the user (4.6 Information for general use of the software) |
- Запуск программы | |
- Входные точки в программу* | Access, or log-on and sign-off the software (4.6 Information for general use of the software) |
- Способы передачи управления и параметров данных | |
- Выполнение программы | |
-- Описание выполняемой функции 1 | A brief overview of the purpose of the procedure and definitions or explanations of necessary concepts not elsewhere included (4.7 Information for procedures and tutorials) |
-- Формат и возможные варианты команд для выполнения функции 1 | Navigation through the software to access ... functions (4.6 Information for general use of the software) Instructional steps shall be presented in the order of performance (4.7 Information for procedures and tutorials) Documentation shall explain how to interrupt and undo operation during execution of a command and how to restart it, if possible. Documentation shall explain the formats and procedures for user-entered software commands, including required parameters, optional parameters, default options, order of commands, and syntax (4.8 Information on software commands) |
-- Ответы программы на команды выполнения функции 1 | Documentation shall describe how to recognize that the command has successfully executed or abnormally terminated (4.8 Information on software commands) |
- Завершение выполнения программы | Navigation through the software ... to exit from functions Methods of canceling, interrupting, and restarting operations (4.6 Information for general use of the software) |
Дополнительные возможности | |
- Описание дополнительных функциональных возможностей программы | |
- Описание применения дополнительных функциональных возможностей программы | |
Сообщения программы | Relevant warnings, cautions, and notes that apply to the entire procedure (4.7 Information for procedures and tutorials) |
- Тексты сообщений, выдаваемых в ходе (настройки, проверки, выполнения) программы | |
-- Описание содержания | |
-- Описание действий, которые необходимо предпринять по этим сообщениям |
Дата добавления: 2016-04-14; просмотров: 654;