Технический писатель

Мы разрабатываем цифровую систему управления и учета производственных процессов (MES-уровня), входящую в экосистему продуктов BFG.

Цель продукта – замкнуть цепочку управления предприятием, обеспечив обратную связь между «идеальным» планом и реальным производством. Система позволяет перейти от теоретического моделирования к оперативному управлению заданиями на рабочих местах.
Наш продукт включён в реестр отечественного ПО и внедряется на реальных заводах для диспетчеризации цехового уровня. Мы закрываем задачи оперативного планирования и контроля исполнения заказов, работая в связке «IT — производство». Наша команда строит продукт, который должен быть понятен рабочему у станка, мастеру смены и руководителю цеха.

Миссия компании – повысить производительный потенциал общества через качественные технологические решения.

Задачи:

• Разрабатывать, актуализировать и поддерживать в актуальном состоянии комплект эксплуатационной документации на систему;
• Обеспечивать соответствие эксплуатационной документации требованиям ГОСТ 34.201-2020 и ГОСТ Р 59795-2021;
• Вести документацию в парадигме Docs-as-Code: хранить исходные тексты в системе контроля версий (Git), обеспечивать автоматическую сборку и публикацию документации;
• Писать и поддерживать документацию в форматах Markdown и reStructuredText;
• Организовывать и поддерживать структуру внутреннего пространства документации: единый стиль, шаблоны документов, правила актуализации, версионность, навигацию;
• Разрабатывать и внедрять внутренние стандарты оформления (style guide) и шаблоны для авторов;
• Поддерживать и пополнять внутреннюю базу знаний в Confluence;

• Совместно с аналитиком и командой разработки собирать исходные данные для документирования;

• Разрабатывать проектную документацию в соответствии с нормативной базой (ГОСТ 34.x, ГОСТ 19.x, РД 50-34.x.);

• Разрабатывать и поддерживать документацию по программным интерфейсам (API), в том числе с использованием спецификаций

  Swagger/OpenAPI;

• Готовить сопроводительные материалы к релизам;

• Совместно с архитекторами и разработчиками описывать процессы и архитектурные аспекты системы с применением нотаций: BPMN, IDEF0, UML.

Что мы ожидаем:

• Опыт работы техническим писателем в IT от 2 лет: эксплуатационная и/или проектная документация;
• Сильная структура текста: логика, единый стиль, терминология, глоссарий;
• Умение создавать комплект документации с нуля при отсутствии или неполноте ТЗ на систему, опираясь на анализ продукта и интервью с командой;
• Знание и практическое применение ГОСТ Р 59795-2021 как основного стандарта, определяющего содержание документов на автоматизированные системы;
• Опыт работы с документацией в промышленной сфере (машиностроение, ВПК) с пониманием специфики заказчиков и строгих требований к документообороту;
• Опыт построения документации по модели Docs-as-Code: вы умеете организовать хранение исходников в Git и публикацию документации как части процесса разработки;
• Практический опыт работы с нормативной документацией: ГОСТ 34.х (34.201, 34.602), ГОСТ Р 59795-2021, ГОСТ Р 57100-2016 (ISO/IEC/IEEE 42010);
• Понимание процесса разработки ПО: постановка задач, ревью, релизы, сопровождение.

Инструменты:

• Confluence (структурирование, ведение и актуализация внутреннего пространства документации);
• Git (ведение документации как кода);
• Markdown/reStructuredText;
• Схемы: draw.io / Visio (или аналоги) для создания и поддержки архитектурных и процессных диаграмм.

Условия работы:

• Компания находится в реестре аккредитованных ИТ-компаний;
• Удалённый формат (возможно посещение офиса в Ижевске);
• Заработная плата: обсуждается индивидуально по результатам собеседования (официальное оформление по ТК РФ);
• Оплачиваемый отпуск и больничные по ТК РФ;
• 4 дополнительных оплачиваемых выходных в год;
• Возможности профессионального и карьерного роста в разработке, и других направлениях;
• График: 5-дневная рабочая неделя, 40 часов;
• Испытательный срок 3 месяца.