Сегодня я расскажу вам об еще одном приятном техписовском приемчике

На уходящей неделе я работал с документом под названием «Пояснительная записка к техническому проекту».

Это стандартный многостраничный документ (в моем случае записка была ок. 90 страниц), у него типовое содержание, и по стандарту в начале документа, в разделе «Подтверждение соответствия проектных решений действующим нормам и правилам …» (или аналогичном) техпис должен перечислить эти самые нормы и правила, которые разработчики учитывали при разработке заказанной системы.

И вот техпис их перечисляет по очереди:

1. ГОСТ № « тут какое-то длинное название 1»;
2. ГОСТ № « тут какое-то длинное название 2»;
3. Приказ №… государственного органа1;


35. Постановление Правительства от … № … «Об утверждении новых нормативов на … тут название на 5 строчек»

А потом, под этим разделом есть еще один раздел «Сведения об использованных при проектировании нормативно-технических документах» (или аналогичный) , который во многом дублирует уже упомянутый выше раздел. И вот эти все перечисления заняли в моем случае добрых 10 страниц, которые нормальный читатель вынужден перелистывать, не особо вчитываясь.

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

Что можно в этом случае сделать?

Оказывается, ГОСТ разрешает делать в этой «Пояснительной записке» раздел «Ссылочные документы» (что-то типа привычной многим из нас «Библиографии»), утащить эти списки документов туда, причем, можно выкинуть из обоих списков дубли (у меня это сократило документ почти на 4 страницы), и в самом тексте ссылаться на эти документы просто номерочками в квадратных скобках. Особо дотошный читатель, если захочет, всегда найдет все нужные документы и ссылки, а не очень дотошный просто пролистнет эти полстранички — всем удобно.

На экране скриншоты того, как это в итоге стало выглядеть у меня (разумеется, всю конфиденциальную инфу я вырезал) .

<i>Отсылка к нормативным актам в начале документа </i>
Отсылка к нормативным актам в начале документа 
<i>Список нормативных документов отдельным разделом в конце документа </i>
Список нормативных документов отдельным разделом в конце документа 

Надеюсь, будет полезно.

Начать дискуссию