от компании (организации): Mail.Ru Group, Решения для бизнеса в городе (населённом пункте): Москва, Россия
в отрасли экономики "Информационные технологии, интернет, телеком" → "Технический писатель"
с заработной платой: по договоренности
Вакансия № 17752099 добавлена в базу данных сайта Работа в Москве и Московской области (МО, Подмосковье): Среда, 21 августа 2024 года.
Дата обновления вакансии № 17752099 на сайте Работа в Москве и Московской области (МО, Подмосковье): Пятница, 20 сентября 2024 года.
Обращаем Ваше внимание, что на момент обращения к работодателю вакансия № 17752099 может быть уже занята. Администрация сайта Работа в Москве и Московской области (МО, Подмосковье) приносит извинения за доставленные неудобства.
Требования к опыту работы:
1–3 года
Тип занятости:
полная занятость
График работы:
полный день
Дополнительные сведения о вакансии: Технический писатель (Tarantool)
О чем мы пишем:
— Tarantool (Тар?нтул) — база данных и сервер приложений, работающие в оперативной памяти, то есть очень быстро. В Tarantool можно писать логику обработки данных на языке Lua. Это тоже очень быстро работает и удобно в разработке;
— Cartridge — конструктор для разработки и управления кластером баз данных;
— Tarantool Data Grid (далее TDG) — платформа для анализа данных, которой удобно пользоваться неразработчикам;
— модули Tarantool, коннекторы для разных языков программирования, инструменты для развертывания.
В ближайшие полгода-год ты будешь писать в основном про Cartridge и TDG. Про первый мы пишем на английском. Про второй пока что на русском, но есть план перехода на английский. Документацию для новой версии TDG нужно будет писать во многом с чистого листа.
В чем ценность документации:
Тарантул — внутренняя разработка компании Mail.ru Group. Компания использует его во многих своих проектах (например, Почта и облачный сервис МСS). Есть и внешние пользователи. Обычно это крупные банки и телекомы.
Хорошая документация очень важна для внутренних и внешних пользователей, продаж и успеха заказной разработки. Наши разработчики радеют за хорошие доки, охотно помогают нам с ревью и часто пишут сами.
Кто нас читает:
— разработчики в команде Tarantool, в других подразделениях компании и во всем мире. Для них мы пишем про устройство базы данных, разработку приложений на Lua и другой хардкор;
— разработчики, которые интегрируют Tarantool в другие системы. Для них мы описываем API коннекторов на C++, Python, PHP, Go и Java;
— администраторы, которые занимаются развертыванием, мониторингом и поддержкой инсталляций Tarantool, Cartridge и TDG. У нас есть Ansible-роль для развертывания «на железо» и оператор для Kubernetes. Обо всем этом мы тоже пишем;
— аналитики, которые используют в своей работе веб-интерфейс TDG. Им мы рассказываем про интерфейсы и сценарии в них.
Как мы работаем:
Используем подход «документация как код». Пишем исходники документации на языке разметки, версионируем с помощью Git, все задачи и ревью (рецензирование) — на GitHub. Благодаря этому у нас все публикуется за 10–15 минут, форматирование не ломается, тексты не теряются, картинки не пропадают. Про любую строку можем сказать, кто, когда и зачем ее редактировал.
Ядро Tarantool — продукт с открытым исходным кодом. Большая часть исходников документации тоже открыта и лежит на GitHub. Командный стайлгайд ведем в общей документации.
В команде есть свой разработчик. Он делает для нас инструменты и автоматизацию. Проверять корректность разметки и качество документа нам помогают автотесты. Пока они совсем простые, скоро их будет больше. По сайту собираем пользовательскую аналитику и отзывы, учитываем их при планировании задач. Раньше сами переводили с английского на русский, сейчас внедряем непрерывную локализацию и отдаем переводы на аутсорс.
Если интересны детали — мы используем Sphinx, reStructuredText, немного Markdown, локально собираем в Docker, используем GitLab CI и Travis, но переезжаем на GitHub Actions, в тесты добавим Vale.
Требования к работнику на вакансии: Технический писатель (Tarantool)
Ищем технического писателя с хорошим письменным английским и русским, который умеет и любит:
— работать со сложной предметной областью: самостоятельно разбираться в ней и закапываться в детали;
— структурировать информацию, объяснять сложные штуки понятным языком и находить удачные формулировки;
— думать и заботиться о читателях, изучать их и совершенствовать свою работу.
Будет полезен опыт разработки, администрирования или работы в техподдержке. Здорово, если вы знакомы хотя бы с Git, командной строкой и языками разметки. Если не знакомы, мы вас научим за пару недель.
Откликнуться на эту вакансию: Технический писатель (Tarantool)
Предыдущая вакансия:
Вакансия № 17752092 на должность Заместитель заведующего аптечным складом от компании АО Воск+ в городе (населенном пункте) Москва