Всё для технического документирования
+7 (495) 001-40-42
Разработка технической документации
Курсы для технических писателей
Программное обеспечение

Писательские навыки против технических, или что я понял, решая судоку (часть 2)

30.04.2014

30.04.14Думаем, предыдущая статья заинтриговала наших читателей. Казалось бы, как связаны судоку и карьера технического писателя? Но Тома Джонсона эта несложная головоломка навела на интересные мысли. Начало истории тут.


Утром я показал дочери, как решать головоломку. Стратегия поставила её в тупик.

Этот опыт заставил меня задуматься о головоломках и моём мозге. Несмотря на то, что меня всё равно никогда никто не увидит решающим судоку для собственного удовольствия, подобные испытания мне даже нравятся. Как технический писатель, каждый день я сталкиваюсь с маленькими неизвестностями, которые приходится решать. Создание алгоритма для решения конкретного вопроса — один из путей решения головоломок / решения проблем. Я обнаружил, что мой мозг замыкается на решении головоломки/кода/проблемы, и не отпускает, пока я не решу задачу.

Это одна из причин, по которой я решил теснее связать свою карьеру с документацией для разработчиков. Мне нравятся головоломки по решению логических проблем. Это намного интереснее, чем простое редактирование уже написанных статей.

Также мне нравится представлять, как части работают вместе, отдельно от кода. Я часто устраиваю безжалостное тестирование методом проб и ошибок, чтобы понять, как всё работает. Как только я разобрался, я тут же пишу описание с объяснением и перехожу к следующей проблеме.

Если мне придётся охарактеризовать свою работу в качестве технического писателя, в основном это выяснение «как что-то работает». Это забавная часть и необязательно письменная. Когда я только начинал, я думал, что это будет отличной возможностью испробовать мои писательские навыки в деловой сфере. Я не ожидал, что истинным занятием будет выяснять принципы работы вещей.

В статьях у меня в блоге часто можно встретить одинаковую механику выяснения принципов работы чего-то. Чаще всего я начинаю с проблем, которые я обдумываю, и придумываю идеи на этот счёт. Я что-то пишу только в качестве инструмента для нахождения решения.

К тому моменту, когда я достаточно повоевал с проблемой, блог уже оказывается написанным. Письмо – это инструмент для мышления, не сама цель. Я считаю, что большинство писателей, пытающихся начать карьеру техписа, этого не понимают. Они хороши как писатели, но слова ради слов пусты (по крайней мере, в корпоративном смысле). Мало кто способен увлечённо писать объяснения процедур или задач, или ещё чего-то. Если вы сможете в своей карьере переместить акцент с создания новых слов на язык и писательство как средства решения задач, думаю, работа техническим писателем в IT принесёт вам куда больше удовольствия.

Возвращаясь к основному вопросу, «технический писатель на 90% технарь и на 10% писатель?»

Я бы ответил, что это на 90% решение проблемы и на 10% написание. Большинство этих проблем технические, с разной степенью сложности. Но вопрос не в том, любите ли вы технологии, а в том, любите ли решать проблемы.

Источник: Writing skills versus technical skills, or, What I realized in solving a Sudoku puzzle

Тэги: , ,

< Вернуться к списку публикаций

Облако тегов