Технический писатель — MaaS
Местоположение: Сингапур, SG
Компания: Bitdeer Technologies Group
Тип занятости: Полная занятость
О Bitdeer:
Bitdeer — ведущая мировая технологическая компания в области майнинга Биткойна и облачных вычислений для ИИ.
Bitdeer стремится предоставлять комплексные решения для майнинга Биткойна своим клиентам. Помимо разработки передовых ASIC-чипов и производства майнингового оборудования, Группа занимается сложными процессами, связанными с вычислениями по всей цепочке создания стоимости. Это включает закупку оборудования, транспортную логистику, проектирование и строительство центров обработки данных, управление оборудованием, а также эксплуатацию сетей и объектов. Bitdeer также предлагает расширенные облачные возможности клиентам с высоким спросом на искусственный интеллект.
Штаб-квартира Bitdeer находится в Сингапуре, компания работает по всему миру, располагая диверсифицированным энергетическим портфелем мощностью 3 ГВт, и развертывает центры обработки данных для майнинга Биткойна и HPC в США, Бутане, Норвегии, Канаде, Малайзии и Эфиопии.
О роли
Мы ищем технического писателя, который будет отвечать за сквозную разработку документации для разработчиков платформы MaaS Bitdeer AI, охватывающую справочник API, руководства для начинающих и примечания к выпускам для быстроразвивающегося каталога размещенных конечных точек для чатов, завершения, встраивания и тонкой настройки. В настоящее время разработчики, интегрирующие наш API для инференса, часто вынуждены реконструировать формы запросов и ответов из внутренних коллекций Postman, напрямую спрашивать инженеров в Slack или обнаруживать критические изменения параметров только после того, как их интеграция завершится сбоем в рабочей среде, что замедляет время до первого успешного вызова и создает излишнюю нагрузку на службу поддержки инженерной команды. Эта роль призвана решить эту проблему, превращая наши спецификации OpenAPI, каталог моделей и поведение конечных точек в точную, версионированную, всегда актуальную документацию, которой разработчики могут доверять как единому источнику достоверных сведений, а также установив периодичность выпуска примечаний, соответствующую обновлениям моделей и конечных точек. Человек, который добьется успеха на этой должности, будет комфортно читать код сервисов на Go и различия в API, чтобы точно писать о них, относиться к документации как к продукту со своим собственным циклом выпуска, а не как к второстепенной задаче, и сможет самостоятельно работать с несколькими инженерными командами, чтобы извлекать точные технические детали из людей, которые не склонны их записывать.
Ваши обязанности:
- Ответственность за справочник API: Поддерживать и постоянно улучшать справочник API на основе OpenAPI, охватывающий конечные точки для чатов/завершений, встраивания, тонкой настройки и маршрутизации моделей. Проверять, соответствуют ли документированные схемы запросов/ответов, коды ошибок и ограничения скорости фактическому поведению сервиса, проводя тестирование на промежуточных и производственных конечных точках. Работать напрямую с бэкэнд-инженерами для фиксации новых параметров, устареваний и крайних случаев поведения до их выпуска для клиентов.
- Руководства для начинающих и по онбордингу: Разрабатывать и поддерживать руководства, которые проведут нового разработчика от регистрации до первого успешного вызова инференса, включая аутентификацию, краткие руководства по SDK и распространенные шаблоны интеграции для поддерживаемых языков. Постоянно выявлять точки оттока в воронке онбординга с помощью обращений в службу поддержки и отзывов разработчиков, и сначала переписывать наиболее слабые этапы. Поддерживать актуальность и работоспособность примеров кода, тестируя их с живым API, а не позволяя им устаревать.
- Дисциплина выпуска примечаний и журнала изменений: Установить и проводить регулярный процесс выпуска примечаний, связанный с обновлениями каталога моделей, новыми конечными точками, изменениями цен и критическими изменениями API, чтобы разработчики никогда не были застигнуты врасплох изменением в рабочей среде. Координировать с продуктовой и инженерной командами циклы выпуска для публикации примечаний до или в момент развертывания, а также четко обозначать устаревания, шаги по миграции и сроки их прекращения.
- Конвейер Docs-as-Code и информационная архитектура: Управлять инструментарием документации (Markdown/MDX, проверка на основе Git, линтинг и генерация спецификаций OpenAPI), чтобы документация была версионирована, подлежала проверке и тестированию так же, как код. Организовать растущую область моделей, конечных точек и руководств в информационную архитектуру, которая останется удобной для навигации по мере расширения каталога моделей. Сократить дублирование или противоречивый контент в справочниках, руководствах и внутренних вики.
- Межфункциональное извлечение технических данных: Проводить интервью с инженерами, менеджерами по продуктам и сотрудниками службы поддержки для получения точных технических сведений о новых функциях, особенностях поведения моделей и известных ограничениях, а также преобразовывать ад-хок знания в структурированную, легко обнаруживаемую документацию. Присутствовать на обзорах запуска моделей и проектирования API на ранних этапах, чтобы документировать решения и обоснования, а не только окончательный синтаксис, и возражать, когда предлагаемые API или сообщения об ошибках будут трудны для документирования или использования.
- Петля обратной связи с разработчиками: Инструментировать и отслеживать сигналы использования документации (поисковые запросы без результатов, обращения в службу поддержки, ссылающиеся на отсутствующую или неверную документацию, отзывы на страницы документации) для определения приоритетов исправления. Сообщать о повторяющихся пробелах в документации инженерной и продуктовой командам как о показателе проблем с удобством использования API, а не только как о проблемах качества написания.
Чем вы выделитесь:
- Иметь более 5 лет профессионального опыта технического писателя, из которых не менее 2 лет специализации на документации API или SDK для продукта, ориентированного на разработчиков, в идеале в компании, специализирующейся на API, инфраструктуре или облачных/ИИ-платформах.
- Продемонстрировать практический опыт создания и поддержания спецификаций OpenAPI/Swagger и генерации справочной документации на их основе, а не ручного написания справочной документации с нуля.
- Представить портфолио опубликованных руководств для начинающих, кратких руководств или учебных пособий, которые помогли разработчику перейти от нуля к рабочей интеграции, с явными доказательствами того, что вы написали (а не просто отредактировали) технический контент.
- Иметь практические навыки работы с инструментарием docs-as-code: Markdown/MDX, управление версиями на основе Git и проверка запросов на слияние, а также генераторы статических сайтов или платформы документации (например, Docusaurus, Mintlify, ReadMe, GitBook или аналогичные).
- Уметь читать код (Go, Python или TypeScript) и трассировки API достаточно хорошо, чтобы самостоятельно проверять точность документации, не дожидаясь, пока инженеры предоставят вам готовые спецификации.
- Иметь опыт проведения процесса выпуска примечаний или журнала изменений для продукта, который часто обновляется, включая координацию времени публикации с циклами выпуска инженеров.
Что вы получите, работая с нами:
- Культура, ценящая подлинность и разнообразие мыслей и опыта;
- Инклюзивная и уважительная среда с открытыми рабочими пространствами и захватывающим духом стартапа;
- Быстрорастущая компания с возможностью наладить контакты с пионерами отрасли и энтузиастами;
- Возможность напрямую вносить вклад и влиять на будущее индустрии цифровых активов;
- Участие в новых проектах, разработка процессов/систем;
- Личная ответственность, автономия, быстрый рост и возможности для обучения;
- Привлекательные социальные льготы и возможности для развития, такие как обучение и наставничество.
Bitdeer стремится предоставлять равные возможности трудоустройства в соответствии с законами страны, штата и местными законами. Bitdeer не допускает дискриминации сотрудников или соискателей по таким признакам, как раса, цвет кожи, гендерная идентичность и/или выражение, сексуальная ориентация, семейное и/или родительское положение, религия, политические взгляды, национальность, этническое происхождение или социальное происхождение, социальный статус, инвалидность, возраст, статус коренных народов и членство в профсоюзе.
