Технический писатель — Managed K8s
Местоположение: Сингапур, SG
Тип занятости: Полная занятость
О Bitdeer:
Bitdeer — ведущая мировая технологическая компания в области майнинга биткоина и облачных вычислений для искусственного интеллекта.
Bitdeer стремится предоставлять комплексные решения для майнинга биткоина своим клиентам. Помимо разработки ведущих в отрасли ASIC-чипов и производства майнингового оборудования, Группа занимается сложными процессами, связанными с вычислениями по всей цепочке создания стоимости. Это включает закупку оборудования, транспортную логистику, проектирование и строительство дата-центров, управление оборудованием, а также эксплуатацию сетей и объектов. Bitdeer также предлагает передовые облачные возможности для клиентов с высоким спросом на искусственный интеллект.
Штаб-квартира Bitdeer находится в Сингапуре, компания имеет глобальное присутствие с диверсифицированным энергетическим портфелем мощностью 3 ГВт и развертывает дата-центры для майнинга биткоина и HPC в США, Бутане, Норвегии, Канаде, Малайзии и Эфиопии.
О роли
Мы ищем технического писателя, который возьмет на себя ответственность за документацию нашей платформы Kubernetes для AI Cloud — справочники по API, документацию по SDK и CLI, руководства по Terraform provider, пути для начала работы и заметки о выпуске, которые позволят клиентам развертывать и управлять самостоятельными GPU-кластерами без обращения в службу поддержки. Это не роль корректора: вы будете напрямую изучать исходный код и изменения плоскости управления API, SDK, CLI и Terraform provider, проверять каждый документированный запрос и ответ в рабочей среде и обновлять документацию в момент изменения интерфейса, а не после того, как клиент подаст заявку в службу поддержки. Вы будете управлять конвейером «документация как код» — версионирование вместе с кодовой базой, сборка и проверка в CI, публикация синхронно с каждым выпуском — чтобы документация выпускалась в тот же день, что и новая функция, а не через несколько недель. Заметки о выпуске рассматриваются как контракт: каждое нарушающее изменение, устаревшее поле и измененное значение по умолчанию должны быть указаны с достаточной точностью, чтобы клиент мог исправить свою интеграцию за минуты, а не отлаживать необъяснимые сбои в производственной среде. Вы будете рассматривать растущий объем обращений в службу поддержки по любой теме как опережающий индикатор пробела в документации, отслеживая повторяющиеся обращения до отсутствующих шагов, неверных значений по умолчанию или недокументированных крайних случаев в жизненном цикле кластера, развертывании, рабочих процессах консоли, IaC, биллинге и безопасности, и устранять этот пробел. Эта роль предполагает тесное взаимодействие с инженерным отделом: вы будете читать PR, затрагивающие общедоступные интерфейсы, и возражать, если API выпускается без документированного пути миграции.
За что вы будете нести ответственность:
- Справочная документация по API, SDK и CLI: Ответственность за справочную документацию по API плоскости управления, SDK, CLI и Terraform provider, написание непосредственно на основе OpenAPI spec и исходного кода, а не на основе вторичных описаний от инженеров. Проверка каждого запроса, ответа и кода ошибки в реальной среде перед публикацией и автоматическое перегенерация справочных страниц из схемы, где это возможно, чтобы избежать незаметного накопления расхождений.
- Руководства по началу работы и самостоятельной настройке: Создание и поддержка путей для новых клиентов, которые проведут их от регистрации до развертывания рабочей нагрузки GPU — создание кластера, развертывание, навигация по консоли, настройка IaC — без взаимодействия со службой поддержки. Структурирование руководств по ролям клиентов (администратор платформы, настраивающий кластер, или разработчик приложений, развертывающий рабочую нагрузку), чтобы каждый читатель следовал кратчайшему пути к достижению своей цели.
- Заметки о выпуске и информация о нарушающих изменениях: Ответственность за периодичность выпуска заметок, написание точных, практичных для клиента записей обо всех нарушающих изменениях, устаревших полях, измененных значениях по умолчанию и новых возможностях, выпущенных платформой. Координация с инженерным отделом перед каждым выпуском для подтверждения того, что шаги миграции документированы и протестированы, а не предполагаются.
- Владение конвейером «документация как код»: Создание и эксплуатация конвейера «документация как код» — контент, версионируемый в git, сборка и проверка в CI, развертывание по той же схеме, что и выпуски продукта — чтобы документация никогда не была ручным, внеплановым этапом. Поддержка инструментария (генерация статических сайтов, версионирование документации, поиск, проверка примеров) как инженерной инфраструктуры с собственным уровнем надежности.
- Устранение пробелов на основе обращений в службу поддержки: Мониторинг объема обращений и тенденций тем с командой поддержки и рассмотрение устойчивых вспышек по любой функции как сигнала о том, что изменение требуется в документации, а не в продукте. Выпуск исправления, а затем отслеживание того, действительно ли объем обращений по этой теме снизился, замыкая цикл, а не считая обновление документации завершенным после слияния.
- Межфункциональное взаимодействие с инженерами: Чтение проектной документации и PR, затрагивающих общедоступные интерфейсы, достаточно рано, чтобы документировать функции до запуска, а не после первого недоумевающего клиента. Партнерство с продуктовой командой и инженерами для обеспечения того, чтобы новые возможности сопровождались охватом руководств по началу работы и справочной документацией с первого дня, и сигнализирование о том, когда предлагаемое изменение API или CLI будет трудным для самостоятельного использования клиентом.
Как вы сможете выделиться:
- Опыт работы более 2 лет в качестве технического писателя для API, облачных или инфраструктурных продуктов, ориентированных на разработчиков, с прямым владением справочной документацией по API и документацией для начала работы для платящих клиентов. Опыт документирования Kubernetes, GPU-инфраструктуры или других сложных систем плоскости управления будет большим преимуществом.
- Демонстрация практического технического владения: вы можете достаточно хорошо читать Go или TypeScript, чтобы проверить документированное поведение по исходному коду, работать непосредственно со спецификациями OpenAPI и самостоятельно запускать CLI, SDK и Terraform provider, чтобы подтвердить, что каждый пример действительно работает перед его публикацией. Вы комфортно работаете в среде Kubernetes (kubectl, Helm, развертывание кластера), а не документируете ее по чужим рассказам.
- Покажите подтвержденный опыт управления конвейером «документация как код» — контент на основе git, сборка и проверка в CI, версионированная публикация, синхронизированная с циклом выпуска программного обеспечения — включая выбор и поддержку инструментария (генераторы статических сайтов, генерация справочной информации на основе OpenAPI, версионирование документации). Вы должны иметь возможность указать на конкретный конвейер, который вы создали или значительно улучшили.
- Имейте опыт написания заметок о выпуске и информации о нарушающих изменениях для API, на который полагаются клиенты в производственной среде, достаточно точной, чтобы клиенты могли действовать на основе этой информации, не обращаясь в службу поддержки. Вы понимаете, как структурировать уведомление об устаревании или руководство по миграции, чтобы предотвратить эскалацию обращений в службу поддержки, а не инициировать их.
- Способность работать с данными обращений в службу поддержки для приоритизации задач по документированию, сотрудничая с поддержкой и инженерами для выявления того, где отсутствующая или неясная документация приводит к увеличению объема обращений. Вы напрямую общаетесь с инженерами о предстоящих изменениях API и можете вести техническую беседу о компромиссах в проектировании, а не просто документировать результат.
Что вы получите, работая с нами:
- Культура, которая ценит аутентичность и разнообразие мыслей и взглядов;
- Инклюзивная и уважительная среда с открытыми рабочими пространствами и захватывающим духом стартапа;
- Быстрорастущая компания с возможностью налаживать контакты с пионерами и энтузиастами отрасли;
- Возможность напрямую вносить вклад и влиять на будущее индустрии цифровых активов;
- Участие в новых проектах, разработка процессов/систем;
- Личная ответственность, автономия, быстрый рост и возможности для обучения;
- Привлекательные социальные льготы и возможности для развития, такие как обучение и наставничество.
Bitdeer стремится предоставлять равные возможности трудоустройства в соответствии с законами страны, штата и местного законодательства. Bitdeer не дискриминирует сотрудников или соискателей по таким признакам, как раса, цвет кожи, гендерная идентичность и/или выражение, сексуальная ориентация, семейное и/или родительское положение, религия, политические убеждения, национальность, этническое происхождение или социальное происхождение, социальный статус, инвалидность, возраст, статус коренного населения и членство в профсоюзе.
