I AM HIRED

Неделя 310 ₽Месяц 630 ₽3 месяца 1 680 ₽Год 5 680 ₽

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

Тексты и переводы · сегодня, 16:05 · 21.11.2026

Зарплата не указана

Откликнуться

Локация: не указана

Формат: не указан

Занятость: не указана

Грейд: Middle

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

Мы в поиске технического писателя на проект нашего партнёра — крупной технологической компании.

Что нужно делать:

— Разработка и поддержка технической документации продукта.

— Документирование REST API (Swagger/OpenAPI): эндпоинты, параметры, примеры запросов/ответов, коды ошибок; описание flows аутентификации и авторизации (OAuth 2.0/OIDC, JWT, Keycloak).

— Ведение Runbook / Troubleshooting Guide, Release Notes / Changelog, README, ADR.

— Работа по Docs-as-Code: Git + Markdown → CI/CD → статический сайт; ветки, PR, review, линтеры документации.

— Создание диаграмм (PlantUML / Mermaid / ••••••••), скриншотов и скринкастов для user-facing документации.

— Документирование сценариев авто-тестирования, подготовка отчётов по результатам тестирования.

— Взаимодействие с аналитиками, разработкой и DevOps: документация как часть Definition of Done, участие в демо и сбор обратной связи.

Что мы ждем от будущего коллеги:

— Опыт разработки технической документации от 2 лет.

— Опыт документирования API и систем аутентификации; широкий кругозор в ИТ (сети, ОС, БД, API).

— Понимание OAuth 2.0 / OpenID Connect на уровне описания flows, структуры JWT; знакомство с терминологией Keycloak (Realm, Client, Role, User, Authentication Flow).

— Обзорное понимание TLS: версии, handshake, сертификаты (CA, самоподписанные, цепочка доверия).

— Уверенный Git: branching, merge vs rebase, разрешение конфликтов, PR/review, log/diff/blame, .gitignore.

— Docs-as-Code на практике: Markdown (tables, admonitions, includes), генераторы статических сайтов (MkDocs, Docusaurus, Antora или аналоги)

Swagger/OpenAPI (Redoc, Swagger UI), PlantUML / Mermaid / ••••••••

Confluence (пространства, шаблоны, макросы) и Jira (связь задач с документацией, DoD)

— Опыт написания руководств администратора и пользователя, API Reference, Runbook, Release Notes, README

Будет преимуществом:

— Знание ГОСТов на документацию (ГОСТ 34.602, ГОСТ 19.402)

— Навыки работы с генеративными AI-моделями, опыт создания и использования AI-агентов для анализа, генерации и автоматизации

Откликнуться на вакансию

Поиск по вакансиям

Название компании скрыто

Названия компаний и их продуктов мы не публикуем на сайте — они доступны в Telegram-боте I AM HIRED. Откройте эту вакансию в боте: увидите название, сможете откликнуться и настроить рассылку подходящих вакансий.

Открыть вакансию в боте