DocOps engineer

Удаленка | от 120 000 до 150 000 руб. | documentat.io

О компании:

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

По бизнес-модели и внутренним процессам мы больше всего похожи на компании заказной разработки программного обеспечения, только мы пишем не софт, а документацию на софт. Как следствие, технические писатели у нас — главные сотрудники, вокруг которых мы и строим свою компанию.

Кого мы ищем:

• Мы ищем опытного технического писателя, способного самостоятельно (или во главе команды техписателей) создавать документационные порталы для различных программных продуктов.
• Мы ожидаем, что вы сможете взять на себя как инструментальную часть разработки документации (выбор инструментального стека и языков разметки), так и текстовую (написание топиков, ревью наработок других техписателей, разработка гидов по стилю).
• Мы ожидаем, что вы будете курировать все хронологические этапы создания документационных порталов: от профилирования целевой аудитории и продумывания структуры контента до поддержки конвейеров автоматической публикации. Средняя длина проекта в нашей компании — 5–6 месяцев, поэтому вы будете проходить эти этапы регулярно для каждого нового проекта.

Почти вся документация, которую вы будете писать, будет англоязычной.

Что вы будете делать:

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

Обязательные требования:

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

Будут большим плюсом:

• Опыт автоматизации переводов и поддержки многоязычных документационных порталов: знакомство с CAT-инструментарием, опыт его интеграции в документационные конвейеры CI/CD.
• Опыт программирования хотя бы в области решения документационных задач. Будет здорово, если вы писали текстовые трансформации на Python или создавали расширения/плагины к своим любимым SSG.
• Владение CSS, JavaScript и языками шаблонизации для кастомизации HTML-выдачи SSG.
• Опыт работы с DITA.
• Опыт создания гидов по стилю для документации.

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

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

ОТКЛИКНУТЬСЯ

Будем рады, если к вашему отклику вы приложите сопроводительное письмо и примеры документации, разработанной вами.

Скорее всего, мы попросим вас выполнить тестовое задание.