Как стать автором
Обновить

Комментарии 2

Последнее время очень регулярно сталкиваюсь с г...документацией, написанной даже вроде в соответствии с ГОСТами, но по сути - ради галочки....

Почти вся виденная в последнее время техдокументация страдает от одной единственной вещи - техписы НЕ ЗНАЮТ, ДЛЯ ЧЕГО ОПИСЫВАЕМАЯ ИМИ ВЕЩЬ И КАК ЭФФЕКТИВНО С ЕЁ ПОМОЩЬЮ ДЕЛАТЬ ТУ РАБОТУ, ДЛЯ КОТОРОЙ ОНА ПРЕДНАЗНАЧЕНА.
Вот и ограничивается всё по сути описанием элементов, которые в идеале должны быть самопонятными.
А потом, например в ИТ, через год-два валом начинают выходить книги разной степени практической направленности - для чайников, приёмы и секреты работы и т.п.

"Ни в форумах, ни в блогах, ни в России, ни в англоязычных ресурсах я не смог найти информацию о том, как логично упаковать всю релевантную фактуру в приятный технический документ."

Нужно в стандартах было искать))

ГОСТы 34 и 19 серии относятся к документации (её наличии), а не содержанию, так что ждать от них большего, не стоит.

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

Рассматривать/определять причины, следствия и варианты решений (не ТЗ) в не рамок компетенции ИТ служб. Для этого предусмотрены, теми же стандартами, свои процедуры. К тому же, надеяться на заказчика (его видение), не самая лучшая затея, а использование стандартных конструкций объектов, убережёт вас от последующих доработок.

Советую начать с концепции CALS (ИПИ), в ней есть, хотя бы, ссылки на стандарты (стандарты по СИ).

стандарты

ГОСТ Р 7.0.101-2018/ИСО 30301:2011 ИНФОРМАЦИЯ И ДОКУМЕНТАЦИЯ. СИСТЕМЫ УПРАВЛЕНИЯ ДОКУМЕНТАМИ. ТРЕБОВАНИЯ

19440 - конструкции моделирования
57100 - описание архитектуры (42010) СиПИ. Описание архитектуры
15704 - ТРЕБОВАНИЯ К СТАНДАРТНЫМ АРХИТЕКТУРАМ И МЕТОДОЛОГИЯМ ПРЕДПРИЯТИЯ
14258 - КОНЦЕПЦИИ И ПРАВИЛА ДЛЯ МОДЕЛЕЙ ПРЕДПРИЯТИЯ
57193 - СиПИ. Процессы жизненного цикла систем

19439 Основа (Среда)моделирования предприятия Framework for enterprise modeling
62264-1 Интеграция систем управления предприятием. Часть 1. Модели и терминология

19011 управление аудитами

Зарегистрируйтесь на Хабре, чтобы оставить комментарий

Публикации

Изменить настройки темы

Истории