Профессия "Технический писатель", или "Рыцари клавиатуры" | страница 17
Но почему так важно делить эта два направления — внутреннее и внешнее? Почему нельзя отправить самого разработчика документировать собственное детище? Причин две.
Первая — разумное использование времени. Программист быстро и качественно пишет код программы, техпис — текст документации. Но если заставить программиста писать документацию — он будет корпеть надо ней значительно дольше, чем технический писатель, а время — это деньги. Написание программистом документации смотрится, на самом деле, ничуть не лучше, чем техпис, разбирающийся в программировании, который пишет программу — да, он её напишет, но потратит уйму времени и код, скорее всего, будет далёким от идеала и вообще не оптимизированным.
Вторая — умение писать тексты и документацию — не тождественные понятия. Внутри компании — люди, полностью знающие продукт, а за её пределами — клиенты, которые о нём не имеют представления. И, как показывает практика — разработчики продукта не могут качественно описать его для постороннего пользователя. Их можно долго и упорно учить, тренировать, из них можно сделать техписов (если очень хочется и совсем нечего больше делать), но свою собственную разработку они даже в таком случае не смогут качественно описать. Это проверенная десятилетиями истина, которую невозможно изменить. И можно даже привести простой пример — если вас попросят описать своих родителей, вы вряд ли выдадите что-то объективное и членораздельное. Да, вы знаете их «от и до», буквально всё о них, но описать их вам не удастся — в голове будет столь много мыслей, что наружу (помимо дежурного «Э...») прорвётся всего одна-две из них.
Так же и в случае с разработчиками — они знают о своём творении всё, они глубоко погружены в свою разработку, что они никогда не смогут взглянуть на него со стороны. И уж тем более — поставить себя на место пользователя, который не знает ничего об их продукте, а значит — не смогут написать документацию просто и доходчиво. Для них всё очевидно, и принять противоположную точку зрения — невыполнимая задача. Если у кого-то возникают сомнения в этом, сообщаем, что в психологии есть термин «Проклятие знания», суть которого состоит в том, что более информированным людям чрезвычайно сложно рассматривать какую-либо проблему с точки зрения менее информированных людей. И этот феномен был многократно подтверждён в ходе психологических экспериментов с участием добровольцев.
А технический писатель, который сам изучает созданный продукт, без проблем поставит себя на место нового пользователя — ведь сам техпис был им, когда начинал описание продукта и общение с разработчиками. Кроме того, разработка текстов — профильное направление техписа, а значит его опыт и навыки в этом деле многократно выше, чем у других специалистов, которые связаны с этим «постольку-поскольку». Именно это и позволяет техническим писателям практически в полной мере избавиться от «проклятия знания» и доходчиво объяснять очевидные для них вещи даже самым неподготовленным пользователям.
