Аренадата Софтвер

Technical writer

Не указана
  • Москва
  • Полная занятость
  • Удаленная работа
  • От 3 до 6 лет
  • Docs-as-code
  • Antora
  • AsciiDoc
  • Markdown
  • Sphinx
  • Hugo
  • Gatsby
  • reStructuredText
  • Английский язык

Мы разрабатываем новый open source проект Greengage DB (собственный форк Greenplum) и ищем Technical writer, который будет создавать документацию для данного продукта.

Нам нужен автор, который по-настоящему увлечен технической документацией, имеет опыт самостоятельного развертывания продуктов, знает языки программирования либо по крайней мере интересуется ими. Идеальный кандидат для нас — это человек, который в прошлом был разработчиком, инженером, системным аналитиком, тестировщиком либо обучался этому, но впоследствии выбрал путь технического писателя.

С нашей текущей документацией можно ознакомиться на сайте docs.arenadata.io. В 2024 году наш сайт был номинирован на международную премию DevPortal Awards. Об истории развития портала документации в компании, а также внутренних процессах отдела технических писателей можно прочитать в нашем техническом блоге.

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

  • Разрабатывать документацию нового open source проекта Greengage DB на английском и русском языках с использованием методологии docs-as-code (Antora + AsciiDoc).

Мы ожидаем, что вы:

  • имеете опыт написания различной технической документации на современные IT-продукты (пошаговые руководства, концептуальные статьи, описания UI, CLI, API).
  • готовы к глубокому изучению наших продуктов при поддержке со стороны наших технических менеджеров, архитекторов, системных аналитиков и разработчиков. Это включает развертывание и настройку тестовых стендов в облаке, установку всех необходимых сервисов, написание и запуск SQL-запросов, а также кода на других языках программирования.
  • способны проводить самостоятельное тестирование описываемого функционала, выполняя все описываемые в документации шаги.
  • имеете опыт работы с системами контроля версий (GitHub/GitLab).
  • являетесь опытным пользователем Linux либо хотите развиваться в этом направлении.
  • знакомы по крайней мере с одним из SSG-движков (Antora, Sphinx, Hugo, Gatsby и др.) и/или языком разметки текстов (AsciiDoc, reStructuredText, Markdown и др.).
  • понимаете базовые принципы работы CI/CD и имеете навыки работы с основными DevOps-инструментами, такими как Docker.
  • умеете писать документацию как на русском, так и на английском языках.

Будет здорово, если:

  • знакомы с основами СУБД и писали SQL-запросы.