TGViewer
Technical Writing 101 🇺🇦 Technical Writing 101 🇺🇦 @technical_writing · 1.45K subscribers
Post #540 1.84K
🌀The career-changing art of reading the docs

☝🏼О пользе документации, но слегка в другом ключе, нежели мы, да и вы все привыкли.

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

Даже если у вас нет никаких стремлений к тому, чтобы привлечь внимание публики, очень важно быть специалистом в своей технической нише. У тех, кто проективно изучает что-то из своей сферы, отличная карьера и гарантированная работа, потому что подобные авторитетные знания крайне редки. Автор статьи приводит в пример себя. Он провел несколько лет(!), работая DBA, однако он пользовался довольно узким набором знаний и решал проблемы исключительно по мере их поступления, и никаких глобальных знаний в области SQL за несколько лет так и не обрёл.

🚀🚀🚀

Я ОЧЕНЬ согласен с этой статьей, так как периодически консультирую как знакомых технических писателей, так и тех, кто нашел меня в LinkedIn или через этот канал. Консультирую по очень разным вещам, включая те, с которыми по работе совсем не встречался, однако читал и разбирался в этом в свое свободное время. 

Повторяющаяся проблема многих (но далеко не всех, пишите если что, помогу чем смогу), кто ко мне стучится за вопросом\советом — это или простейшая лень или желание быстро решить проблему %n%, не желая вникать в детали.

Приведу пример из последнего: Написал мне Техпис, спросил совета, ну и в итоге возникла проблема с непечатными символами в конфиге, и, как оказалось, для него концепция невидимых символов чужда. Я предложил ему лично изучить, что же это за символы такие и как они работают, на что получил ответ (дословная цитата): “Разбираться в этом не хочется. Не понятно, зачем это нужно.”

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

🚀🚀🚀

В статье автор приводит три распространенных возражения/отговорки, которые возникают у людей, которым автор советует читать документы в качестве стратегии карьерного роста и набор контраргументов к этим же возражениям: 

1️⃣ «У меня не фотографическая память. Я никогда не запомню кучу случайных документов»
2️⃣ «У меня нет времени читать кучу документации»
3️⃣ «Документы для [технологии X] никуда не годятся. Поверьте, их не стоит читать»

❓Что там за контраргументы? Читайте саму статью, она действительно стоит потраченного времени.

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

🔗Читать: The career-changing art of reading the docs

#career #article #en
  • ❤ 1
More from @technical_writing
  1. May 14, 2025📊 State of Docs 2025 is here! The State of Docs 2025 report just dropped — super interest…
  2. Jul 17, 2024🚀 Exciting update for technical writers and developers using Google Docs! 📝 Now, you can…
  3. Jun 26, 2024photo post
  4. Jan 27, 2023environmental documentation
  5. Dec 23, 2022Есть чувство, шо GitHub вот-вот перевернет рэп игру своей новой функцией Blocks. Blocks ー…
  6. Dec 22, 2022Допомоги/Підтримки пост Гайз, хочемо поділитись з вами штучним інтелектом який може створи…
Threads Profile ViewerView any public Threads profile without an account.Open ThreadLook →Writing with AI? Make it sound human.Metric37 rewrites AI drafts so they read naturally. Free AI detector, 1,500 words free.Try Metric37 →