Comments 4
Отлично. Понравилась и первая статья.
Пара вопросов:
Как Вы учитываете требования ГОСТов?
SCHEMA ST4 санкционные ограничения есть?
Спасибо за отзыв и вопросы.
Архитекторы контента делают макет, а дальше авторы (наши специалисты по сертификации, которые работают с ГОСТами), пишут и публикуют контент с учетом их требований. Подробнее о работе с ГОСТами мы рассказывали на конференции TeamLead Conf. Выступление можно посмотреть на Youtube.
Ответила в личных сообщениях.
Здравствуйте.
Статья очень интересная.
Вы писали: "Все эти документы выложены в виде справки на корпоративном справочном портале (EULA используется унифицированная). Скоро этот портал станет доступен внешним пользователям."
Скажите, это уже доступно? Можете дать ссылку?
И ещё такой вопрос. Комплект документации на "четвёрку" у вас состоит из 4-х документов - руководства администратора, справочного руководства по REST API, справочного руководства по правилам обработки трафика и Release Notes. Ну, по сути, три, т.к. Release Notes это мелочёвка. Сколько человек трудилось над этим комплектом и какое время? Ну или может, сможете человеко-часы указать?
Здравствуйте! Спасибо за вопросы и положительный отзыв!
1. Портал станет доступен к концу года, сейчас мы активно работаем над его наполнением.
2. Комплект документов на PT AF 4.x.x готовит один технический писатель, вычитывает один редактор, а фактическую вычитку выполняет вся команда тестировщиков проекта PT AF. Release Notes небольшой документ, но отличается по стилю подачи, поэтому он также трудоемкий. Этот документ входит в релизный комплект документов, то есть мы поставляем его в срок к каждому релизу. Релиз ноты готовит несколько человек на проекте. На подготовку документа к релизу писатель тратит около 40% своего времени, остальное время уходит на другие проекты и внутренние задачи.
История обрастания контентом одного продукта: как мы с нуля развивали техническую документацию