Ведущий технический писатель / DocOps engineer

от 120 000 до 150 000 руб. на руки

Требуемый опыт работы: 3–6 лет

Полная занятость, удаленная работа



Наша компания занимается заказной разработкой технической документации. Мы помогаем другим 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-компаний. У нас вы сможете применить свой широкий опыт на пользу совершенно разным бизнесам и целевым аудиториям.

• За счет разнообразных проектов и предметных областей экспертиза наших техписателей растет кратно быстрее, чем в других компаниях.

• У нас не бывает проблем вида «документацию никто не читает» — наши заказчики четко знают, зачем им нужна документация и какие задачи она должна решать.



Наш офис находится в Новосибирском Академгородке, но у нас можно работать и удаленно.

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

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

 Доступно соискателям с инвалидностью 

Адрес

Новосибирск, Советский район, микрорайон Академгородок, улица Демакова, 30

Вакансия опубликована 2 ноября 2019 в Новосибирске

Смотреть отклик
Написать сопроводительное письмоПисьмо отправлено

Сопроводительное письмо к отклику