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

Orion soft — российский разработчик ИТ-продуктов, в основу которых заложена концепция программно-определяемого ЦОД.‍

В портфель решений входит флагманский продукт zVirt, платформа управления виртуализацией Cloudlink, система терминального доступа Termit, система управления секретами StarVault, а также Nova Container Platform — платформа оркестрации контейнеризированных приложений на базе Kubernetes и ближайший в РФ аналог продукту Red Hat Openshift. Он включает в себя преднастроенные, безопасные Kubernetes-кластеры с большим количеством дополнительных сервисов.

Наша команда активно расширяется и ищет Технического писателя.‍

Твои задачи:

• Ведение релизной документации: подготовка, структурирование и выпуск документации к новым релизам продукта (Release Notes, руководства по обновлению, описание новых возможностей и API-изменений);

• Актуализация документации: поддержка версий документации по продукту в актуальном состоянии;

• Техническое ревью и тестирование: проверка документации по продукту на соответствие реальному поведению системы;

• Сопровождение и развитие базы знаний продукта: актуализация и расширение базы знаний совместно с командами инженеров СТП и разработки;

• Обратная связь и развитие: сбор и обработка обратной связи по документации, приоритизация улучшений.

Наши ожидания:

• Владение технологиями Docs as Code: ты уверенно используешь популярные языки разметки (Markdown, Asciidoc), имеешь опыт работы с системами контроля версий;

• Системный подход: ты умеешь видеть документацию не как набор страниц, а как систему со своей архитектурой. Ты знаешь, когда нужно создать новую страницу, а когда — рефакторить и перераспределять существующий контент;

• Git-компетенции: опыт работы с GitLab (ветки, решение конфликтов, работа с CI/CD для документационных проектов);

• Ориентация на пользователя: ты умеешь переписывать сложные технические описания так, чтобы их мог использовать инженер среднего уровня, и при этом не терять точность;

• Коммуникации: ты умеешь эффективно взаимодействовать с командой и организовывать процесс разработки документации;

• Администрирование Linux: ты уверенно работаешь в командной строке Linux (bash/zsh), умеешь настраивать сетевые интерфейсы, управлять процессами, работать с файловой системой, анализировать логи и диагностировать проблемы на уровне ОС;

• Понимание Kubernetes: ты знаешь базовые сущности, умеешь читать и понимать манифесты YAML, ориентируешься в архитектуре микросервисов и принципах оркестрации контейнеров;

• Техническая любознательность: ты не боишься заходить в код и конфигурации продукта, чтобы проверить корректность документации, и умеешь задавать правильные вопросы разработчикам.

Здорово, если ты:

• Имеешь опыт работы с SSG Hugo (управление шаблонами, настройка frontmatter);

• Имеешь опыт работы с OpenAPI / Swagger;

• Владеешь графическими редакторами для создания схем и диаграмм;

• Разбираешься в Helm-чартах и умеешь читать шаблоны Helm;

• Знаком с системами мониторинга (Prometheus, Grafana) и умеешь описывать метрики и алерты;

• Знаком с платформами для управления секретами (например, Hashicorp Vault).