TGViewer
Technical Writing 101 🇺🇦 Technical Writing 101 🇺🇦 @technical_writing · 1.45K subscribers
Post #587 3.19K
Джулия Эванс, регулярный гость в нашем уютном бложике, но на этот раз не с своими прекрасными Зинами Для Программистов, а с перечнем так-себе-паттернов затрудняющих восприятие информации и кайфовые примеры к ним.

💥паттерн 1: делать устаревшие предположения об знаниях аудитории
💥паттерн 2: наличие противоречивых ожиданий относительно знаний читателя
💥паттерн 3: натянутые аналогии
💥паттерн 4: забавные иллюстрации на сухих объяснениях
💥паттерн 5: нереалистичные примеры
💥паттерн 6: жаргон, который ничего не значит
💥паттерн 7: отсутствует ключевая информация
💥паттерн 8: вводится слишком много концепций одновременно
💥паттерн 9: начинаете абстрактно
💥паттерн 10: неподдерживаемые ничем утверждения
💥паттерн 11: нет примеров
💥паттерн 12: объяснять «неправильный» способ сделать что-то, не говоря, что это неправильно
💥паттерн 13: «что» без «почему»

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

🔗 Читать: Patterns in confusing explanations

#visual #en #example
  • ❤ 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 →