Получи случайную криптовалюту за регистрацию!

Джулия Эванс, регулярный гость в нашем уютном бложике, но на э | Technical Writing 101 🇺🇦

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

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

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

Читать: Patterns in confusing explanations