После тщательного пересмотра книга «Автоматизация разработки технической документации с применением AuthorIT. Учебное пособие» вернулась на свою историческую родину — https://authorit.ru. Обновленная версия доступна в режиме онлайнового просмотра, изначальная — по указанной выше ссылке. Редакция от 17.12.2024.

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

Концепция обеспечения информационной безопасности ГИС — документ, разработанный на основе РД ГТК (ныне — ФСТЭК) РФ, позволяющий «избавить» автоматизированную систему от секретности, конфиденциальности и прочих приятных вещей, отягощающих проектирование АС. Редакция от 17.12.2024.

Пример документа «Массив входных данных» (В6 по ГОСТ 34.201–89), разработанного для автоматизированной измерительно–информационной системы коммерческого учета электроэнергии (АИИС КУЭ) согласно требованиям подраздела Массив входных данных по РД 50–34.698–90 к структуре, содержанию и содержимому документа. Оформлен по ГОСТ 2.104 и ГОСТ 2.106. Редакция от 17.12.2024.

Любопытный модуль Drupal 7 HTML import. Если хорошо структурированный стилями заголовков документ ворда сохранить в формате HTML, а затем хорошенько почистить с помощью Dreamweaver, то можно получить ноды из заголовков.

Сокращенный перевод описания, комментарии после развертывания, настройки и проверки работоспособности. Редакция от 21.12.2024.

Текст доклада о качестве технической документации, планировавшегося к прочтению на конференции «Разработка ПО 2012» CEE-SECR 2012 в центре Digital October, Москва, Россия, 1-2 ноября 2012 г. По стечению обстоятельств у автора не оказалось возможности приехать и выступить с этим докладом на секции т.н. «технических писателей». Редакция от 29.04.2021.

О командах проекта и проектных командах замолвим мы слово… Поскольку в разработке технической документации ради самой ее разработки нет ни логики, ни смысла, услуга эта имеет обыкновение «вклиниваться» в различные проекты в качестве одной из основных решаемых задач, а где проекты — там и проектные команды. Приходится взаимодействовать с их участниками и невольно наблюдать происходящие внутри этих команд процессы. Но о курсах по мотивации сотрудников в статье мы упоминать не будем 😀 Редакция от 18.12.2024.

Стандартизация — богатейшая предметная область для исследований как в профессиональном, так и в культурно-историческом аспекте: ведь ГОСТы, разработанные, принятые и введенные в действие до появления национальной стандартизации (ГОСТ Р), направленной в сторону «гармонизации» с ИСО, во многом отражают историю отечественной техники. Много любопытного и забавного в терминологии: это и двусмысленность, и отдельные неуклюжие попытки русификации забугорных терминов. Хватает и грустного — это о гармонизации. Редакция от 19.11.2024.

Всегда выигрывает в сумме

От этой перемены мест.

© В. Гафт

Прям с фишкинет и заимствован, спасибо художнику! Итак, цель комплекса задач:

Пример документа «Описание автоматизированных функций» (П3 по ГОСТ 34.201–89), разработанного для автоматизированной измерительно–информационной системы коммерческого учета электроэнергии (АИИС КУЭ) согласно требованиям подраздела Описание автоматизированных функций по РД 50–34.698–90 к структуре, содержанию и содержимому документа. Оформлен по ГОСТ 2.104 и ГОСТ 2.106. Редакция от 17.12.2024.