Читаем Профессия "Технический писатель", или "Рыцари клавиатуры" полностью

Таким образом, для всех остальных специалистов, кроме технических писателей, умение писать хорошие тексты и грамотно формулировать свои мысли — серьёзное подспорье в их основной деятельности, на которой они и должны сосредоточиться. Все их тексты должны «жить» внутри компании и ни в коем случае не «выходить наружу», в отличие от результатов труда техписа, который работает «во вне», создавая документы для пользователей за пределами компании.

Но почему так важно делить эта два направления — внутреннее и внешнее? Почему нельзя отправить самого разработчика документировать собственное детище? Причин две.

Первая — разумное использование времени. Программист быстро и качественно пишет код программы, техпис — текст документации. Но если заставить программиста писать документацию — он будет корпеть надо ней значительно дольше, чем технический писатель, а время — это деньги. Написание программистом документации смотрится, на самом деле, ничуть не лучше, чем техпис, разбирающийся в программировании, который пишет программу — да, он её напишет, но потратит уйму времени и код, скорее всего, будет далёким от идеала и вообще не оптимизированным.

Вторая — умение писать тексты и документацию — не тождественные понятия. Внутри компании — люди, полностью знающие продукт, а за её пределами — клиенты, которые о нём не имеют представления. И, как показывает практика — разработчики продукта не могут качественно описать его для постороннего пользователя. Их можно долго и упорно учить, тренировать, из них можно сделать техписов (если очень хочется и совсем нечего больше делать), но свою собственную разработку они даже в таком случае не смогут качественно описать. Это проверенная десятилетиями истина, которую невозможно изменить. И можно даже привести простой пример — если вас попросят описать своих родителей, вы вряд ли выдадите что-то объективное и членораздельное. Да, вы знаете их «от и до», буквально всё о них, но описать их вам не удастся — в голове будет столь много мыслей, что наружу (помимо дежурного «Э...») прорвётся всего одна-две из них.



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

А технический писатель, который сам изучает созданный продукт, без проблем поставит себя на место нового пользователя — ведь сам техпис был им, когда начинал описание продукта и общение с разработчиками. Кроме того, разработка текстов — профильное направление техписа, а значит его опыт и навыки в этом деле многократно выше, чем у других специалистов, которые связаны с этим «постольку-поскольку». Именно это и позволяет техническим писателям практически в полной мере избавиться от «проклятия знания» и доходчиво объяснять очевидные для них вещи даже самым неподготовленным пользователям.

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


6. Профессия технического писателя в РФ и за рубежом

 О профессии технического писателя мы сами сказали уже много хорошего, поэтому теперь стоит посмотреть, как с ней обстоят дела в России и мире с точки зрения сухой статистики.

1. Обучение. В СНГ, скажем коротко, его нет. Если точнее — то у нас невозможно получить высшее образование по профессии «Технический писатель», нет даже ничего похожего (заставить программиста отучиться на журналиста или наоборот — не предлагать). Из всех возможностей освоить профессию «с нуля» или повысить свою квалификацию остаются коммерческие курсы, например, проводимый ООО «Протекст» курс «Разработка технических текстов и документации» (https://protext.su/pro/kurs/), представляющий собой набор лекций и практических занятий. Он позволит начать работу по этой специальности, но не даст диплома по ней. Увы, сейчас его не даст никто и неизвестно, когда изменится эта ситуация.

Перейти на страницу:

Похожие книги

Исторические информационные системы: теория и практика
Исторические информационные системы: теория и практика

Исторические, или историко-ориентированные, информационные системы – значимый элемент информационной среды гуманитарных наук. Его выделение связано с развитием исторической информатики и историко-ориентированного подхода, формированием информационной среды, практикой создания исторических ресурсов.Книга содержит результаты исследования теоретических и прикладных проблем создания и внедрения историко-ориентированных информационных систем. Это первое комплексное исследование по данной тематике. Одни проблемы в книге рассматриваются впервые, другие – хотя и находили ранее отражение в литературе, но не изучались специально.Издание адресовано историкам, специалистам в области цифровой истории и цифровых гуманитарных наук, а также разработчикам цифровых ресурсов, содержащих исторический контент или ориентированных на использование в исторических исследованиях и образовании.В формате PDF A4 сохранен издательский макет.

Динара Амировна Гагарина , Надежда Георгиевна Поврозник , Сергей Иванович Корниенко

Зарубежная компьютерная, околокомпьютерная литература / Учебная и научная литература / Образование и наука
Внутреннее устройство Microsoft Windows (гл. 1-4)
Внутреннее устройство Microsoft Windows (гл. 1-4)

Книга посвящена внутреннему устройству и алгоритмам работы основных компонентов операционной системы Microsoft Windows — Windows Server 2003, Windows XP и Windows 2000 — и файловой системы NTFS. Детально рассмотрены системные механизмы: диспетчеризация ловушек и прерываний, DPC, APC, LPC, RPC, синхронизация, системные рабочие потоки, глобальные флаги и др. Также описываются все этапы загрузки операционной системы и завершения ее работы. B четвертом издании книги больше внимания уделяется глубокому анализу и устранению проблем, из-за которых происходит крах операционной системы или из-за которых ее не удается загрузить. Кроме того, рассматриваются детали реализации поддержки аппаратных платформ AMD x64 и Intel IA64. Книга состоит из 14 глав, словаря терминов и предметного указателя. Книга предназначена системным администраторам, разработчикам серьезных приложений и всем, кто хочет понять, как устроена операционная система Windows.Названия всех команд, диалоговых окон и других интерфейсных элементов операционной системы приведены как на английском языке, так и на русском.Версия Fb2 редакции — 1.5. Об ошибках просьба сообщать по адресу — general2008@ukr.net.

Дэвид Соломон , Марк Руссинович

Зарубежная компьютерная, околокомпьютерная литература / Прочая компьютерная литература / Книги по IT
Справочник по параметрам BIOS
Справочник по параметрам BIOS

В справочнике в алфавитном порядке приведено описание большинства параметров современных BIOS. В краткой форме описаны большинство настроек BIOS, даны рекомендуемые значения для различных конфигураций компьютеров. Также рассказано, что представляет собой BIOS, какие типы BIOS существуют, как получить доступ к BIOS и обновлять ее.Кроме того, вы научитесь использовать различные функции BIOS, узнаете, как оптимизировать их с целью улучшения производительности и надежности системы.Для более глубокого понимания работы BIOS и детального рассмотрения ее функций рекомендуем обратиться к книге «Оптимизация BIOS. Полное руководство по всем параметрам BIOS и их настройкам» А. Вонга.Книга предназначена для всех пользователей компьютера – как начинающих, которые хотят научиться правильно и грамотно настроить свою машину, используя возможности BIOS, так и профессионалов, для которых книга окажется полезным справочником по всему многообразию настроек BIOS. Перевод: А. Осипов

Адриан Вонг

Зарубежная компьютерная, околокомпьютерная литература