В жизни каждого из нас как в профессиональной сфере, так и в быту, очень часто встречаются ситуации, когда собеседники не понимают нас. В эти моменты мы задаёмся примерно такими вопросами - Почему меня не понимают? Как объяснять так, чтобы меня понимали? Сегодня немного порассуждаю на эту тему и постараюсь найти нужные ответы.

Ссылка на книгу:

«Искусство объяснять. Как сделать так, чтобы вас понимали с полуслова» Ли ЛеФевер (Lee LeFever)

Уже не раз говорил, что пытаюсь вести просветительскую деятельность по развитию культуры осознанной работы с написанием документации у инженеров. Не всегда мои слова звучат убедительно, так как я не являюсь экспертом в данном вопросе. Но под Новый год случилось чудо! Я нашёл такого эксперта, который поможет мне донести нужную информацию до инженеров. В сегодняшнем выпуске представляю запись беседы с Ариной - техническим коммуникатором с 20-летним опытом работы в IT.

Ссылки на книги:

«Разработка документации пользователя программного продукта» (Юрий Кагарлицкий)

«Пиши, сокращай» (Максим Ильяхов и Людмила Сарычева)

«Живой Как Жизнь» (Корней Чуковский)

«Беседы о русском языке» (Корней Чуковский)

Контакты Арины:

Сообщество технических писателей

Профиль ментора

Абсолютное большинство инженеров вообще не интересуются навыком письма. Обычный ответ в этом случае “Я только код пишу, мне этого достаточно.” И это печально, если честно. Сегодня предлагаю немного порассуждать над вопросом - нужен ли инженерам навык письма или достаточно иметь только технические знания?

A Guide to Writing as an Engineer, 5th Edition

Chapter 1: Engineers and Writing

Today was a Good Day: The Daily Life of Software Developers

Communication for Engineers: A framework for software developers to become better communicators and increase their happiness, productivity, and impact

Diátaxis - подход структурирования и организации технической документации, который значительно упрощает работу с документацией как её разработчикам, так и читателям (пользователям). В сегодняшнем выпуске представлен краткий обзор данного подхода.

diataxis.fr

Daniele Procida

Запись вебинара Introducing the Diátaxis Approach to Technical Documentation (www.brighttalk.com)