Выпуск #19. Делай проще, думай меньше
Опубликовано 10.04.2024
Делай проще, чтобы поняли, да и сам думай меньше, задачу закрыть надо…
В сегодняшнем выпуске поделюсь своими мыслями о тенденции упрощения всего и вся в нашей жизни. И какое участие принимаем в этом процессе мы - инженеры, технические писатели, да и представители многих других профессий.
>> Слушать и читать дальше
Выпуск #18. Успешный и продуктивный
Опубликовано 11.03.2024
Успешный и продуктивный инженер, успешный и продуктивный технический писатель, успешный и продуктивный переводчик и т.д. Многие из нас хотят быть успешными и продуктивными.
В сегодняшнем выпуске я поделюсь своими размышлениями о продуктивности и как она может помочь нам преуспеть в личной и профессиональной жизни.
>> Слушать и читать дальше
Выпуск #17. Юзабилити документации
Опубликовано 20.02.2024
Жизненный цикл разработки любого продукта включает в себя этап тестирования. Более того, тестировать нужно не только функциональность, но и удобство использования (юзабилити). Документация, как продукт, не является исключением.
В сегодняшнем выпуске затрагиваю такую тему, как тестирование удобства использования (usability testing) пользовательской документации.
>> Слушать и читать дальше
Выпуск #16. Понятная инструкция
Опубликовано 02.02.2024
В процессе выполнения одной из основных задач на работе в прошлом году довелось изучить различное программное обеспечение по разработке хранилищ данных, а также документацию к нему. Так плохо написанной документации - в частности, инструкции для администраторов и пользователей - я ещё не встречал. Что больше всего меня опечалило, так это то, что практически всю эту документацию писали инженеры - разработчики продуктов.
Мне стало до того горько и обидно, что я решил написать небольшую инструкцию по написанию инструкций для инженеров, которая хоть как-то могла бы улучшить сложившуюся ситуацию.
В сегодняшнем выпуске представляю аудио-версию моей небольшой работы «Как написать понятную инструкцию. Опыт инженера».
>> Слушать и читать дальше
Выпуск #15. Беседа с Иваном Чаплыгиным (Ч2)
Опубликовано 22.01.2024
В сегодняшнем выпуске представляю вторую часть записи беседы с профессиональным переводчиком Иваном Чаплыгиным, автором книги «Думай о смысле. Будни переводчика IT-текстов».
>> Слушать и читать дальше
Выпуск #14. Беседа с Иваном Чаплыгиным (Ч1)
Опубликовано 18.01.2024
Не устану повторять, что технические коммуникаторы - это не только техническими писатели, как многие привыкли думать. К техническим коммуникаторам можно отнести длинный перечень профессий. Иногда сложно сходу сказать, относится ли какая-то профессия к техническим коммуникаторам.
Вот на примере профессии «Переводчик». Я почему-то был уверен, что к технической коммуникации имеют отношение только специалисты по локализации, которые переводят тексты и надписи для интерфейсов различного программного обеспечения. Я ошибался.
Осознал я свою ошибку после прочтения одной интересной книги о буднях IT-переводчиков и совершенно под другим углом посмотрел на эту замечательную профессию. Кстати, в работе технических писателей и переводчиков очень много общего.
Прочитав книгу, мне захотелось более детально разобраться в нюансах работы переводчиков, так как эти ребята - настоящие коммуникаторы, пусть и не всегда технические.
В сегодняшнем выпуске представляю запись беседы с профессиональным переводчиком Иваном Чаплыгиным.
>> Слушать и читать дальше
Выпуск #13. Почему меня не понимают?
Опубликовано 11.01.2024
В жизни каждого из нас, как в профессиональной сфере, так и в быту, очень часто встречаются ситуации, когда собеседники не понимают нас.
В эти моменты мы задаёмся примерно такими вопросами: Почему меня не понимают? Как объяснять так, чтобы меня понимали?
Сегодня немного порассуждаю на эту тему и постараюсь найти нужные ответы.
>> Слушать и читать дальше
Выпуск #12. Беседа с Ариной Балериной
Опубликовано 28.12.2023
Уже не раз говорил, что пытаюсь вести просветительскую деятельность по развитию культуры осознанной работы с написанием документации у инженеров. Не всегда мои слова звучат убедительно, так как я не являюсь экспертом в данном вопросе.
Но под Новый год случилось чудо! Я нашёл такого эксперта, который может помочь мне донести нужную информацию до инженеров.
В сегодняшнем выпуске представляю запись беседы с Ариной - техническим коммуникатором с 20-летним опытом работы в IT.
>> Слушать и читать дальше
Выпуск #11. Нужен ли инженерам навык письма?
Опубликовано 23.11.2023
Абсолютное большинство инженеров вообще не интересуются навыком письма. Обычный ответ в этом случае: “Я только код пишу, мне этого достаточно.” И это печально, если честно.
Сегодня предлагаю немного порассуждать над вопросом - нужен ли инженерам навык письма или достаточно иметь только технические знания?
>> Слушать и читать дальше
Выпуск #10. Обзор Diataxis (системный подход к созданию технической документации)
Опубликовано 26.10.2023
Diátaxis - подход структурирования и организации технической документации, который значительно упрощает работу с документацией как её разработчикам, так и читателям (пользователям). В сегодняшнем выпуске представлен краткий обзор данного подхода.
>> Слушать и читать дальше
Выпуск #9. Визуализация данных
Опубликовано 19.10.2023
Технические коммуникаторы - это не только техписатели, как многие привыкли считать, это достаточно широкий диапазон профессий. Среди этих профессий присутствуют также специалисты по визуализации данных. В сегодняшнем выпуске рассмотрим визуализацию данных, как вид техкоммуникации.
>> Слушать и читать дальше
Выпуск #8. Процесс разработки технической документации (согласование и публикация)
Опубликовано 11.05.2023
В основе любой деятельности лежит набор определенных процессов. Разработка технической документации не является исключением. В сегодняшнем выпуске о третьем и четвертом этапах процесса создания документации.
>> Слушать и читать дальше
Выпуск #7. Процесс разработки технической документации (разработка)
Опубликовано 27.04.2023
В основе любой деятельности лежит набор определенных процессов. Разработка технической документации не является исключением. В сегодняшнем выпуске о втором этапе процесса создания документации.
>> Слушать и читать дальше
Выпуск #6. Процесс разработки технической документации (подготовка)
Опубликовано 13.04.2023
В основе любой деятельности лежит набор определенных процессов. Разработка технической документации не является исключением. В сегодняшнем выпуске о первом этапе процесса создания документации.
>> Слушать и читать дальше
Выпуск #5. Документация как код
Опубликовано 30.03.2023
Переход российских компаний на парадигму “документация как код” в части создания и сопровождения технической документации, а также для чего нужны и как написать понятные сообщения для git-коммитов.
>> Слушать и читать дальше
Выпуск #4. Дополнение по единому источнику правды
Опубликовано 16.03.2023
Небольшое дополнение к выпуску о едином источнике правды документации.
>> Слушать и читать дальше
Выпуск #3. Уильям Зинсер. Как писать хорошо
Опубликовано 02.03.2023
Отзыв на книгу Уильяма Зинсера “Как писать хорошо. Классическое руководство по созданию нехудожественных текстов”.
>> Слушать и читать дальше
Выпуск #2. Единый источник правды
Опубликовано 16.02.2023
Как развивалась техническая документация? Что такое единый источник правды? Ответы на эти вопросы в данном выпуске подкаста.
>> Слушать и читать дальше
Выпуск #1. Знакомство
Опубликовано 02.02.2023
Сколько русскоязычных подкастов о технических коммуникаторах Вы слушаете? Ну, хотя бы знаете, кто такие технические коммуникаторы?
Ладно, расслабьтесь. Послушайте первый выпуск и всё сразу поймёте.
>> Слушать и читать дальше