Справочник по техническим документам в ИТ: различия между версиями
WikiSysop (обсуждение | вклад) м (Защитил страницу Справочник по техническим документам ([Редактирование=Разрешено только автоподтверждённым участникам] (бессрочно) [Переименование=Разрешено только автоподтверждённым участникам] (бессрочно))) |
|||
Строка 3: | Строка 3: | ||
* Добавлены описания документов, предусмотренных [[Комплекс стандартов на автоматизированные системы|КСАС]] и [[Единая система программной документации|ЕСПД]], [[Единая система конструкторской документации|ЕСКД]] в части эксплуатационной документации. | * Добавлены описания документов, предусмотренных [[Комплекс стандартов на автоматизированные системы|КСАС]] и [[Единая система программной документации|ЕСПД]], [[Единая система конструкторской документации|ЕСКД]] в части эксплуатационной документации. | ||
* Добавлены статьи по терминологии КСАС, ЕСПД и ЕСКД. | * Добавлены статьи по терминологии КСАС, ЕСПД и ЕСКД. | ||
[https://gost34.ru/index.php?title=%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:%D0%92%D1%81%D0%B5_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B&hideredirects=1 Статьи по алфавиту] | |||
= Над чем идет работа = | = Над чем идет работа = | ||
* Составляем комментарии к статьям по гостовским документам и терминам. | * Составляем комментарии к статьям по гостовским документам и терминам. |
Версия от 22:12, 4 апреля 2024
Этот справочник по технической документации в области информационных технологий предназначен для широкого круга специалистов, включая технических писателей, бизнес- и системных аналитиков, архитекторов, а также руководителей проектов и ИТ-менеджеров. Он охватывает описания документов, предусмотренных национальными и международными стандартами, и тех, что выработаны практикой, предлагая цитаты из стандартов, их толкования, комментарии экспертов и сведения из опыта работы. Содержащиеся в справочнике терминологические и вспомогательные статьи призваны поддержать профессионалов в разработке и верстке технической документации. Инициатива носит некоммерческий характер и поддерживается сообществом специалистов в сфере технической документации.
Что уже сделано
- Добавлены описания документов, предусмотренных КСАС и ЕСПД, ЕСКД в части эксплуатационной документации.
- Добавлены статьи по терминологии КСАС, ЕСПД и ЕСКД.
Над чем идет работа
- Составляем комментарии к статьям по гостовским документам и терминам.
Что в планах
- Распространенные документы, не предусмотренные гостами прямо (описание бизнес-процесса, руководство администратора, руководство по установке).
- Документы по управлению ИТ (например, план непрерывности бизнеса, план восстановления после аварии).
- Документы по разработке систем с микросервисной архитектурой (архитектурная диаграмма, спецификация микросервиса, описание REST API).
- Основные виды диаграмм, применяемых в технической документации (диаграмма состояний, диаграмма взаимодействия и др.).
- Документы по информационной безопасности (например, описание модели угроз).
- Организационно-распорядительные документы (положение о системе, различные регламенты).
Сотрудничество
Если вы чувствуете в себе силы участвовать в составлении или обсуждении статей этого справочника, напишите нам, пожалуйста, по адресу editorial@gost34.ru. Сообщите, какие именно темы вас интересуют, и расскажите немного о себе.