Архив: Технический писатель

Documentat.io

Мы компания, которая занимается заказной разработкой технической документации. Мы помогаем другим IT компаниям документировать API и SDK, писать руководства для пользователей, создавать базы знаний для отделов техподдержки и многое другое.

Кого мы ищем?

Наша команда в поиске технического писателя, способного самостоятельно (или во главе команды техписателей) создавать документационные порталы для различных программных продуктов.

Что надо делать?

  • Проектировать порталы документации с нуля: разработка информационной архитектуры и структуры контента, создание шаблона описания типовых элементов, формирование проектные гиды по стилю.
  • Координировать работу команды из 2–3 техписателей.
  • Отвечать за выбор документационного инструментария, для каждого нового проекта отвечать на вопрос «Что здесь лучше применить — легковесные языки разметки, help authoring tool или Confluence?»
  • Настраивать конвейеры CI/CD для проверки и публикации документации, интегрирование документации в существующие процессы работы с кодом — всё то, что называется термином DocOps.
  • Проводить R&D: исследовать новый инструментарий, разрабатывать подходы к документированию, формировать новые индустриальные практики, делиться всем этим с профессиональным сообществом (да, в рабочее время).

Какие требования к соискателям?

  • Уровень английского языка Advanced.
  • Опыт работы техническим писателем в IT компаниях от 3 лет.
  • Опыт:
  1. использования help authoring tools (Author-IT, MadCap Flare);
  2. документирования сложных предметных областей и поддержки крупных (сотни страниц) документационных порталов на английском языке;
  3. настройки конвейеров CI/CD для документации;
  4. документирования HTTP API: понимание концепций REST, владение соответствующим инструментарием (Swagger и другое).
  • Большой опыт работы с легковесными языками разметки (Markdown, RST, AsciiDoc) и с инструментарием вокруг них (SSG типа Sphinx или MkDocs, конвертеры типа Pandoc, линтеры).
  • Знакомство с типичными Git workflows для документации.
  • автоматизации переводов и поддержки многоязычных документационных порталов: знакомство с CAT-инструментарием, опыт его интеграции в документационные конвейеры CI/CD.

программирования хотя бы в области решения документационных задач. Будет здорово, если вы писали текстовые трансформации на Python или создавали расширения/плагины к своим любимым SSG.

  • разработки на CSS, JavaScript и языки шаблонизации для кастомизации HTML-выдачи SSG.
  • с DITA.

Почему у нас интересно?

Потому что наша компания — самое интересное в России место работы для техписателя. Вот что мы под этим понимаем:

  • Мы собираем у себя в команде самых сильных техписателей России. Вам будет на кого равняться и с кем поговорить о насущных профессиональных темах.
  • Техписатели в нашей компании — самые главные и самые важные сотрудники; мы строим все свои процессы вокруг них.
  • R&D, исследование новых инструментов и подходов к документированию, обучение и повышение квалификации техписателей — неотъемлемая часть нашей бизнес-модели. Мы занимаемся этим регулярно, а не по остаточному принципу.
  • Мы решаем документационные задачи для десятков российских IT-компаний. У нас вы сможете применить свой широкий опыт на пользу совершенно разным бизнесам и целевым аудиториям.
  • За счет разнообразных проектов и предметных областей экспертиза наших техписателей растет кратно быстрее, чем в других компаниях.
  • У нас не бывает проблем вида «документацию никто не читает» — наши заказчики четко знают, зачем им нужна документация и какие задачи она должна решать.

Заявка на личную беседу

К сожалению, отклики на эту вакансию уже не принимаются. Возможно, компания нашла подходящего кандидата или позиция потеряла актуальность.