ГОССТАНДАРТ РОССИИ - Информационная технология ПРОЦЕСС СОЗДАНИЯ ДОКУМЕНТАЦИИ ПОЛЬЗОВАТЕЛЯ ПРОГРАММНОГО СРЕДСТВА

c) пункты, содержащие определенные ограничения, и пункты без ограничений должны быть представлены раздельно.

Там, где могут быть использованы скобки или точка с запятой, не следует применять тире.

Необходимо учитывать следующие физические факторы:

a) сокращения нецелесообразно использовать только для экономии места;

b) предусмотреть необходимые места для простановки соответствующих значений, например цены;

c) следует использовать стандартные графические инструментальные средства (пакеты) и избегать применения вклеек;

d) избегать внесения поясняющего текста в рисунки;

e) следует использовать графические символы, имеющие общепринятое смысловое значение;

f) по возможности вместо словесного пояснения использовать графические изображения.

Применительно к диалоговой информации необходимо учитывать следующие положения:

a) при наличии обратной связи с разработчиками программных средств следует обеспечить выделение диалоговой информации (текстов и сообщений) из логики программы;

b) каждый блок текста или сообщение должны иметь индивидуальное идентификационное обозначение

с указанием соответствующей классификационной группы данного текста или сообщения;

c) конкретное программное средство не должно ориентироваться на длину, формат или расположение незащищенных экранных полей ввода-вывода (input and output fields);

d) для каждого понятия следует использовать отдельное сообщение. Сообщения не должны быть надуманными;

e) переменные в сообщении должны содержать только непереводимую информацию, например ключевые слова и коды возврата;

f) из предложений не следует исключать предлоги в целях экономии места.

Применительно к культурным факторам необходимо учитывать следующие положения:

a) иллюстративные материалы (например, лица, животные и звуки речи) должны быть независимыми от национальных культурных особенностей;

b) следует избегать использования примеров, связанных со специфическими национальными традициями или особенностями (например, праздниками, банковским делом, зарплатой, спортом и т. д.);

c) в тексте и иллюстрациях следует избегать использования идиоматических выражений, присущих национальному языку документатора;

d) следует избегать использования юмористических выражений, особенно каламбуров.

e) следует осторожно использовать иронические выражения;

f) необходимо избегать использования сленговых, жаргонных и простонародных выражений;

g) не должны использоваться упоминания первых лиц государства;

h) не следует выражать даты только в числовом виде. Месяц всегда должен быть написан полностью (например, 28 июля 1991);

i) обычно следует использовать двумерные представления, если международные соглашения не требуют иного (например, для автошин, водопроводов, гвоздей и фотопленки);

j) когда метрические величины располагаются вместе с величинами в других системах измерения, из контекста должно быть понятно, какая из величин относится к соответствующей системе измерений.

В настоящем приложении представлен ряд рекомендуемых методов оценки проекта. В ряде случаев эти методы противоречат друг другу, так как оценка проекта документирования достаточно субъективна. В частности, данные оценки могут быть завышенными при внесении изменений в программное средство в процессе его документирования.

Данные методы позволяют сделать практические прикидки, на фактические сроки реализации проекта следует проставлять исходя из практического опыта экспертов, проводящих соответствующие оценки.

Данные методы предусматривают около 3 ч для написания страницы текста, пригодного для публикации. Время, необходимое для создания графических материалов, определяется их сложностью и количеством черновиков, необходимых для создания соответствующего оригинала.

По общей оценке требуется от 3 до 5 ч для создания и корректировки типового графического материала, используемого в программной документации (исключая экранные распечатки).

В начале проекта трудно оценить общий постраничный объем создаваемой документации. Если для завершения проекта требуется более 2 мес, подсчет страниц должен быть проведен по истечении первого месяца.

Для очень больших проектов номенклатура поставки должна быть разделена на части, поддающиеся управлению. При этом оценка сроков завершения проекта в целом может быть дана только в количестве месяцев, а детально может быть оценена лишь первая часть работы. При использовании данного метода документатор и заказчик должны сверить свои оценки сроков завершения проекта.

В таблице F.1 приведены сроки реализации «типового» (гипотетического) проекта. При этом предполагается, что автор готовит материалы непосредственно на персональном компьютере, и для их выпуска используют портативные издательские системы.

Таблица F.1 — Ориентировочные сроки

Данный метод основан на предположении, что число страниц в публикации(ях) может быть оценено достаточно просто с использованием следующих допущений:

a) автор может за месяц подготовить 22 страницы нового текста;

b) автор может за месяц подготовить 44 страницы текста с изменениями.

Например, объем публикации оценен в 150 страниц. Поскольку это новая публикация, получаем: 150/22 = 7 чел./мес. В эти 7 мес входят: планирование публикации, ее написание, редактирование и проверка двух редакций, а также подготовка фотошаблонов.

Продолжительность 7 чел./мес распределена в следующих пропорциональных отношениях:

a) 15 % — планирование (в данном примере — четыре недели);

b) 50 % — написание первой редакции (14 недель);

c) 25 % — написание второй редакции (семь недель);

d) 10 % — подготовка фотошаблонов (три недели).

Период планирования охватывает:

a) исследования и подготовку плана;

b) изучение и проверку плана;

c) корректировку плана по результатам проверки.

Период первой редакции охватывает:

a) подготовку содержания (плана-проспекта) документации;

b) изучение и проверку содержания (плана-проспекта);

c) подготовку пробного куска текста для редактора;

d) редактирование пробного куска текста и его переписывание по замечаниям редактора;

e) написание всей первой редакции документации;

f) редактирование всей первой редакции документации;

g) переработку отредактированной документации;

h) изучение и проверку переработанной документации.

Похожие книги на "Информационная технология ПРОЦЕСС СОЗДАНИЯ ДОКУМЕНТАЦИИ ПОЛЬЗОВАТЕЛЯ ПРОГРАММНОГО СРЕДСТВА", ГОССТАНДАРТ РОССИИ читать полностью, без сокращений.

Майкл Фарадей - История свечи

Моисей Радовский - Фарадей

Сержио Рарра Кастильо - Наука

Яков Абрамов - Майкл Фарадей.

ГОССТАНДАРТ РОССИИ -