Техкомпод - подкаст технического коммуникатора

В одной из бесед с гостем подкаста обсуждалось последствие импортозамещения для консультантов SAP BW, долгие годы использовавших SAP-стек для построение хранилищ данных и аналитических систем. В той беседе был отмечен один из инструментов, который сейчас является, пожалуй, стандартом в сфере работы с данными. Этот инструмент называется dbt - data build tool.Я с ним также познакомился в рамках задач по импортозамещению. В процессе знакомства выполнил небольшой проект, который вылился в руководство по созданию хранилищ данных с помощью dbt. Об этом инструменте, а также руководстве пойдет речь в данном выпуске.Ссылки:Руководство по созданию хранилищ данных с dbt (www.dwh-book.ru)Примечание:Текстовую расшифровку выпуска читайте на сайте подкаста.

Уже не одно десятилетие нас пугают восстанием машин и порабощением ими всего человечества. Активное развитие нейросетей и различных AI-сервисов, или по-простому «искусственного интеллекта» (ИИ), в какой-то степени усугубило ситуацию. Большинство людей заняло две крайние позиции – одни приветствуют и активно используют эту технологию, вторые – категорически отвергают и даже побаиваются. Но всё ли так однозначно? Если ИИ – благо, то как можно использовать его в собственных интересах? Если зло – как можно защититься или, как минимум, снизить риски его применения относительно своей деятельности? Данная тема затрагивает огромное множество профессий, но в сегодняшнем выпуске сфокусируемся на применении «искусственного интеллекта» в техписательстве. Разобраться в обозначенных нелегких (и других смежных) вопросах мне помог Дмитрий Развозжаев, технический писатель, который пытается приручить «искусственный интеллект» для повышения эффективности своей работы.Примечание:Текстовую расшифровку выпуска читайте на сайте подкаста.

Когда-то давным-давно меня пугали, что если я буду делиться своими сокровенными знаниями, то стану ненужным и меня уволят. Какое-то время я так и делал. Со временем осознал, что делаю хуже только самому себе. Но до сих пор мне встречаются коллеги, которые продолжают многие годы жить в этой парадигме сокрытия знаний. Стоит ли бояться делиться своими знаниями? Как правильно организовать процесс передачи и накопления знаний? Разобраться в этих и многих других вопросах мне помогла (по-моему всегда!) веселая и задорная Катя Павлова, директор по продукту Gramax (приложения для подготовки документации).Примечание:Текстовую расшифровку выпуска читайте на сайте подкаста.

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

В сегодняшнем выпуске затронуты вопросы, напрямую или косвенно связанные с замещением зарубежного ПО для создания BI-решений, в частности, линейки продуктов SAP для BI-решений. Какие изменения ожидать консультантам SAP BI в связи с использованием новых инструментов и технологий в их работе? Как формировать и управлять дата-командами тимлидам в новых условиях? Какие тенденции в мире данных сейчас вообще прослеживаются? Разобраться во всех этих вопросах мне помог Владимир Лагутинский, опытный руководитель дата-подразделений различного уровня, как в российских, так и зарубежных компаниях.Примечание:Текстовую расшифровку выпуска читайте на сайте подкаста.

Мир данных уже не тот. Как и всё вокруг нас меняется с немыслимой скоростью, мир данных очень сильно изменился, особенно за последние несколько лет. Если 10–15 лет назад тенденция была такова, что от специалиста требовалось наличие широкого спектра навыков, то ситуация поменялась кардинальным образом – сейчас в тренде узкая специализация. Это приводит к некоторым изменениям в существующих профессиях, а также к появлению новых профессий. Об одной из таких профессий в сегодняшнем выпуске.Рекомендованные источники:Сайт инструмента (в том числе, документация) - www.getdbt.comRoberto Zagni «Data Engineering with dbt: A practical guide to building a cloud-based, pragmatic, and dependable data platform with SQL»Dumky De Wilde и др. «Fundamentals of Analytics Engineering: An introduction to building end-to-end analytics solutions»Примечание:Текстовую расшифровку выпуска читайте на сайте подкаста.

Восхищаюсь практически каждой историей профессионального пути человека, с которым начинаю знакомство и общение. Очень интересно прослеживать процесс становления эксперта в какой-то сфере. Порой диву даёшься от того, как они пришли к сегодняшнему состоянию профессии, какие крутые повороты были в жизни, какие решения были приняты, как раскрывался потенциал и способности и т.д. В сегодняшнем выпуске представляю запись разговора с одним из таких экспертов, мастером своего дела и просто интересным собеседником Константином Макушевым, старшим техническим писателем в Т-Банке.Книги, которые рекомендует Константин:Нора Галь «Живое и мёртвое»Максим Ильяхов «Пиши и сокращай»Уильям Зинсер «Как писать хорошо»Примечание:Текстовую расшифровку выпуска читайте на сайте подкаста.

Делай проще, чтобы поняли, да и сам думай меньше, задачу закрыть надо... В сегодняшнем выпуске поделюсь своими мыслями о тенденции упрощения всего и вся в нашей жизни. И какое участие принимаем в этом процессе мы - инженеры, технические писатели, да и представители многих других профессий.Ссылки:Яшкова Л.А. Упрощение как сущностная характеристика современного человека и угроза гибели // «Омский научный вестник» 2009, № 6. С. 108-111.Примечание:Текстовую расшифровку выпуска читайте на сайте подкаста.

Успешный и продуктивный инженер, успешный и продуктивный технический писатель, успешный и продуктивный переводчик. Многие из нас хотят быть успешными и продуктивными. В сегодняшнем выпуске я поделюсь своими размышлениями о продуктивности и как она может помочь нам преуспеть в личной и профессиональной жизни.Ссылки:«I Built a Secret Habit Building System» (Youtube-канал «Daily Atomic Steps»)«Атомные привычки. Как приобрести хорошие привычки и избавиться от плохих» (Джеймс Клир)Примечание:Текстовую расшифровку выпуска читайте на сайте подкаста.

Жизненный цикл разработки любого продукта включает в себя этап тестирования. Более того, тестировать нужно не только функциональность, но и удобство использования (юзабилити). Документация, как продукт, не является исключением.В сегодняшнем выпуске затрагиваю такую тему, как тестирование удобства использования (usability testing) пользовательской документации.Ссылки:«An Easy Way To Dramatically Improve Technical Documentation Quality» (George Eckel, www.brighttalk.com)«Why You Only Need to Test with 5 Users» (Jakob Nielsen)Примечание:Текстовую расшифровку выпуска читайте на сайте подкаста.

В процессе выполнения одной из основных задач на работе в прошлом году довелось изучить различное программное обеспечение по разработке хранилищ данных, а также документацию к нему. Так плохо написанной документации - в частности, инструкции для администраторов и пользователей - я ещё не встречал. Что больше всего меня опечалило, так это то, что практически всю эту документацию писали инженеры - разработчики продуктов.Мне стало до того горько и обидно, что я решил написать небольшую инструкцию по написанию инструкций для инженеров, которая хоть как-то могла бы улучшить сложившуюся ситуацию.В сегодняшнем выпуске представляю аудио-версию моей небольшой работы «Как написать понятную инструкцию. Опыт инженера».Ссылки:«Как написать понятную инструкцию. Опыт инженера» (Владимир Юсупов)ГОСТ Р 2.601-2019 Единая система конструкторской документации. Эксплуатационные документыБабайцева В.В. Русский язык. Теория. 5 - 11 классыПримечание:Текстовую расшифровку выпуска читайте на сайте подкаста.

В сегодняшнем выпуске представляю вторую часть записи беседы с профессиональным переводчиком Иваном Чаплыгиным, автором книги «Думай о смысле. Будни переводчика IT-текстов».Книга:«Думай о смысле. Будни переводчика IT-текстов» (Иван Чаплыгин)Контакты Ивана:Телеграм-канал: «X-ren переведёшь»Ник: @agrio_chivas

Не устану повторять, что технические коммуникаторы - это не только техническими писатели, как многие привыкли думать. К техническим коммуникаторам можно отнести длинный перечень профессий. Иногда сложно сходу сказать, относится ли какая-то профессия к техническим коммуникаторам.Вот на примере профессии «Переводчик». Я почему-то был уверен, что к технической коммуникации имеют отношение только специалисты по локализации, которые переводят тексты и надписи для интерфейсов различного программного обеспечения. Я ошибался.Осознал я свою ошибку после прочтения одной интересной книги о буднях IT-переводчиков и совершенно под другим углом посмотрел на эту замечательную профессию. Кстати, в работе технических писателей и переводчиков очень много общего.Прочитав книгу, мне захотелось более детально разобраться в нюансах работы переводчиков, так как эти ребята - настоящие коммуникаторы, пусть и не всегда технические.В сегодняшнем выпуске представляю запись беседы с профессиональным переводчиком Иваном Чаплыгиным.Книга:«Думай о смысле. Будни переводчика IT-текстов» (Иван Чаплыгин)Контакты Ивана:Телеграм-канал: «X-ren переведёшь»Ник: @agrio_chivas

В жизни каждого из нас как в профессиональной сфере, так и в быту, очень часто встречаются ситуации, когда собеседники не понимают нас. В эти моменты мы задаёмся примерно такими вопросами - Почему меня не понимают? Как объяснять так, чтобы меня понимали? Сегодня немного порассуждаю на эту тему и постараюсь найти нужные ответы.Ссылка на книгу:«Искусство объяснять. Как сделать так, чтобы вас понимали с полуслова» Ли ЛеФевер (Lee LeFever)

Уже не раз говорил, что пытаюсь вести просветительскую деятельность по развитию культуры осознанной работы с написанием документации у инженеров. Не всегда мои слова звучат убедительно, так как я не являюсь экспертом в данном вопросе. Но под Новый год случилось чудо! Я нашёл такого эксперта, который поможет мне донести нужную информацию до инженеров. В сегодняшнем выпуске представляю запись беседы с Ариной - техническим коммуникатором с 20-летним опытом работы в IT.Ссылки на книги:«Разработка документации пользователя программного продукта» (Юрий Кагарлицкий)«Пиши, сокращай» (Максим Ильяхов и Людмила Сарычева)«Живой Как Жизнь» (Корней Чуковский)«Беседы о русском языке» (Корней Чуковский)Контакты Арины:Сообщество технических писателейПрофиль ментора

Абсолютное большинство инженеров вообще не интересуются навыком письма. Обычный ответ в этом случае “Я только код пишу, мне этого достаточно.” И это печально, если честно. Сегодня предлагаю немного порассуждать над вопросом - нужен ли инженерам навык письма или достаточно иметь только технические знания?A Guide to Writing as an Engineer, 5th EditionChapter 1: Engineers and WritingToday was a Good Day: The Daily Life of Software DevelopersCommunication for Engineers: A framework for software developers to become better communicators and increase their happiness, productivity, and impact

Diátaxis - подход структурирования и организации технической документации, который значительно упрощает работу с документацией как её разработчикам, так и читателям (пользователям). В сегодняшнем выпуске представлен краткий обзор данного подхода.diataxis.frDaniele ProcidaЗапись вебинара Introducing the Diátaxis Approach to Technical Documentation (www.brighttalk.com)

Технические коммуникаторы - это не только техписатели, как многие привыкли считать, это достаточно широкий диапазон профессий. Среди этих профессий присутствуют также специалисты по визуализации данных. В сегодняшнем выпуске рассмотрим визуализацию данных, как вид техкоммуникации.

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

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

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

Переход российских компаний на парадигму “документация как код” в части создания и сопровождения технической документации, а также для чего нужны и как написать понятные сообщения для git-коммитов.

Небольшое дополнение к выпуску о едином источнике правды документации.

Отзыв на книгу Уильяма Зинсера “Как писать хорошо. Классическое руководство по созданию нехудожественных текстов”.

Как развивалась техническая документация? Что такое единый источник правды? Ответы на эти вопросы в данном выпуске подкаста.

Сколько русскоязычных подкастов о технических коммуникаторах Вы слушаете? Ну, хотя бы знаете, кто такие технические коммуникаторы? Ладно, расслабьтесь. Послушайте первый выпуск и всё сразу поймёте.