Технический писатель Google. 3 месяца в компании (часть 3)
17.01.2014
Мы заканчиваем публикацию статьи технического писателя Google Сары Мэддокс. Сегодня мы узнаем, какие инструменты используют работники компании, какими навыками должны обладать и какие преимущества можно получить, устроившись работать в Google.
Слова, код, разметка
Нужно ли уметь писать код, чтобы быть техническим писателем в Google? Это наиболее обсуждаемый вопрос. Я думаю, всё зависит от должности, занимаемой в Google. Для моей позиции, я бы сказала, было бы весьма невыгодно не уметь скомпоновать программный код.
Почти все, что мы создаем – это слова. Мы пишем в HTML или Markdown в зависимости от нашего выбора, либо существующего формата, если мы обновляем документ.
Мы также выработали образцы кода. Для разработчиков, желающих использовать наши API и стандарты, образец кода состоит из тысячи слов. Технический писатель, как правило, просит инженеров помочь с образцами кода, но нам нужно привести его в порядок, чтобы потом судить о его полезности в качестве иллюстративного примера.
Моим первым большим заданием было реорганизовать некоторые документы для API Google Maps JavaScript и создать образцы кода. Я писала о результатах в блоге: Refactoring overlays in the Google Maps JavaScript API documentation.
API, Linux, фиолетовый цвет
Как человек, который документирует API, я могу играть с кодом. Я многое делаю с помощью командной строки, и это довольно сильно отличается от работы на основе wiki (редактируемых страниц), что было моей основной задачей на прошлой работе. У инструментов, которые я использую сейчас, нет возможностей wiki в плане интеграции с социальными медиа, богатства функций редактирования текста и простоты использования для не-технарей. Но с командной строкой и текстовыми редакторами я наслаждаюсь чистотой и простотой.
Знаете ли вы, что можно раскрасить командное окно Linux? А вы хотите это знать? Хе-хе, это одна из вещей, которым я здесь радуюсь. Моё окно сейчас фиолетовое с желтым текстом и голубыми выделениями. Я переключаюсь на чёрно-белые окна, когда приходится использовать редактор для командной строки Linux. В основном я редактирую файлы документов с помощью текстового редактора (Komodo) на Макбуке. Мы вправе использовать инструменты на наш выбор, когда дело доходит до текстовых редакторов, сред разработки, инструментов для обработки изображения, браузеров и так далее.
Места, места, места
Сиднейский офис Google – одно из самых красивых мест в мире. На фотографии запечатлён вид с балкона столовой.
Из офиса в Сан-Франциско потрясающий вид на мост. Пейзаж вокруг штаб-квартиры в Маунтин-Вью успокаивающий зелёный и красочный. Пока я побывала только в трёх офисах.
Три месяца. Три офиса. Неплохо. Я надеюсь увидеть ещё многое.
Еда, еда, еда
Да, слухи, которые вы слышали, верны. Еда повсюду. У нас есть несколько «микрокухонь» на каждом этаже. Микрокухня на самом деле очень большая, и может похвастаться, по крайней мере, двумя типами кофеварок, холодильником, полным напитков, закусок и фруктов.
В каждом здании также есть «кафе», которое является столовой для старшего персонала. Здесь подают полный завтрак и обед. В некоторых кафе сервируют ещё и ужин для тех, кто работает допоздна. Обед состоит из богатого салат-бара, супа, разнообразных закусок и горячего и по крайней мере двух видов десерта. Выбор меняется каждый день. Удивительно.
Люди говорят о «Google 15» – когда вы присоединяетесь к Google, вы получаете 15 преимуществ!
Источник: Google technical writer, 3 months in
Тэги: API, инструменты, опыт, организация работы, профессия, Сара Мэддокс
