Вот уже 6 лет мы развиваем собственную платформу для создания игр и мини-приложений VK Mini Apps. Размещённые на этой платформе приложения помогают пользователям выполнять различные задачи, не покидая ВКонтакте, ничего дополнительно не скачивая и не устанавливая. Платформа строится вокруг HTTP API, мультиплатформенного SDK и библиотек для веб-разработки.
Сейчас мы ищем технического писателя, который займётся материалами портала для разработчиков. Портал описывает библиотеки, API-запросы, подсистемы ВКонтакте, а также содержит инструкции и песочницы для выполнения запросов. Если вы, как и мы, любите Docs as Code или Continuous Documentation, пишите — у нас есть задачи, связанные с автоматизацией создания документации и локализацией.
Вам предстоит:
• создавать документацию для разработчиков;
• разбираться в деталях работы программных продуктов, проверять функциональность и инструкции, предоставлять отзывы, предлагать улучшения;
• писать на русском языке, используя Markdown, а для хранения материалов использовать GitLab;
• работать с разными видами текстов, например помогать с текстами для сообществ или редактировать статьи на других ресурсах.
У нас интересно, потому что вы сможете:
• больше узнать о веб-разработке, использовании API, работе платформы ВКонтакте и связанных с ней продуктов;
• напрямую влиять на результат — портал с документацией создаётся прямо сейчас;
• работать осмысленно — мы самостоятельно решаем, какие инструменты, практики и правила использовать;
• рассчитывать на профессионалов — тексты вычитывает редактор, переводит переводчик.
Мы ожидаем от вас:
• осознанное использование инфостиля — мы его сторонники;
• умение структурировать и понятно объяснять читателям устройство сложных систем и процессов;
• стремление поставить себя на место пользователя, взглянуть на проблему со стороны: описать функциональность и помочь читателю решить его вопрос;
• внимательность к деталям;
• желание разобраться до конца в любой нужной незнакомой области;
• умение работать с Markdown и Git.
Выполнять наши задачи и разговаривать с разработчиками на одном языке вам помогут:
• общая IT-эрудиция;
• минимальные знания JavaScript или любого другого языка — Python, Java, PHP, C#;
• общие знания или практика использования HTML, CSS, React, webpack, npm и других технологий и инструментов, связанных с веб-разработкой;
• представление о работе HTTP-запросов и веб-сервисов REST;
• опыт работы с системами контроля версий, использующими Git;
• умение пользоваться инструментами разработчика в браузере;
• знание командной строки;
• способность без напряжения читать англоязычную техническую литературу.
Отдельным плюсом будет ваш опыт в настройке процессов и внедрении CI/CD — это наша главная цель на ближайшее время.
Приглашаем специалиста, который живет в России и готов работать удалённо или сможет посещать офис в Москве или Санкт-Петербурге. Ждём ваших откликов. Удачи!
