Техписалити!
Kanalga Telegram’da o‘tish
Первая открытая школа технических писателей Пишут Лида Туляганова, Маша Щеблякова и Катя Марченко
Ko'proq ko'rsatish1 982
Obunachilar
-224 soatlar
-27 kunlar
+230 kunlar
Ma'lumot yuklanmoqda...
O'xshash kanallar
Taglar buluti
Kirish va chiqish esdaliklari
---
---
---
---
---
---
Obunachilarni jalb qilish
Avgust '26
Avgust '260
0 kanalda
Iyul '26
+33
1 kanalda
Get PRO
Iyun '26
+31
1 kanalda
Get PRO
May '26
+26
0 kanalda
Get PRO
Aprel '26
+30
0 kanalda
Get PRO
Mart '26
+34
0 kanalda
Get PRO
Fevral '26
+72
1 kanalda
Get PRO
Yanvar '26
+74
0 kanalda
Get PRO
Dekabr '25
+91
2 kanalda
Get PRO
Noyabr '25
+52
0 kanalda
Get PRO
Oktabr '25
+81
0 kanalda
Get PRO
Sentabr '25
+41
0 kanalda
Get PRO
Avgust '25
+76
1 kanalda
Get PRO
Iyul '25
+55
0 kanalda
Get PRO
Iyun '25
+56
0 kanalda
Get PRO
May '25
+52
0 kanalda
Get PRO
Aprel '25
+81
2 kanalda
Get PRO
Mart '25
+85
0 kanalda
Get PRO
Fevral '25
+100
0 kanalda
Get PRO
Yanvar '25
+118
2 kanalda
Get PRO
Dekabr '24
+176
0 kanalda
Get PRO
Noyabr '24
+115
2 kanalda
Get PRO
Oktabr '24
+91
0 kanalda
Get PRO
Sentabr '24
+59
0 kanalda
Get PRO
Avgust '24
+75
0 kanalda
Get PRO
Iyul '24
+83
0 kanalda
Get PRO
Iyun '24
+75
1 kanalda
Get PRO
May '24
+47
1 kanalda
Get PRO
Aprel '24
+105
1 kanalda
Get PRO
Mart '24
+57
1 kanalda
Get PRO
Fevral '24
+97
0 kanalda
Get PRO
Yanvar '24
+141
0 kanalda
Get PRO
Dekabr '23
+53
0 kanalda
Get PRO
Noyabr '23
+61
1 kanalda
Get PRO
Oktabr '23
+81
2 kanalda
Get PRO
Sentabr '23
+454
0 kanalda
| Sana | Obunachilarni jalb qilish | Esdaliklar | Kanallar | |
| 02 Avgust | 0 | |||
| 01 Avgust | 0 |
Kanal postlari
| 2 |  Всем привет!
❤️ Поздравляем коллег из RWB с первым митапом!
Для тех, кто не смог посмотреть, оставляем ссылки на запись)
Посмотрите, как создают документацию в RWB и узнайте, как кабачок стал героем секции ответов на вопросы😉
VK
YouTube | 1 274 |
| 3 |  +4#анонс
Всем привет! Несём новости – 16 июля в 16-00 RWB (Объединённая компания Wildberries&Rus) проведёт первый онлайн-митап по технической документации.
- Техническая документация — это фундамент, - рассказывает член программного комитета, наша коллега и ментор движения Women In Tech Люсьена Мирославская. - От документации зависит, как быстро команда масштабирует знания, как новички вливаются в проект и сколько времени пользователи тратят на изучение продукта. И в этом смысле технический писатель — это не роскошный максимум, а самый что ни на есть базовый минимум. Без него команда теряет эффективность. Приходите послушать, как мы запускаем процессы документирования в наших командах.
В программе:
⏹️ «Летопись документации разработчиков WB API» | Лидия Рудакова, лид команды документирования Public API.
⏹️ «Единая система оценки задач техписателей: как внедрить новый подход без боли» | Евгения Красильникова, технический писатель в команде разработки документации и методик обучения ПО.
⏹️ «100 к 1: Как организовать подход "документация как услуга" в одиночку» | Антон Гафаров, технический писатель в команде FinTech Infra.
Модератор – Екатерина Касаткина.
Митап бесплатный.
Ссылка на регистрацию | 1 488 |
| 4 | #книги #розыгрыш
Друзья, мы подводим итоги розыгрыша книги Екатерины Ушаковой «Если ты — технический писатель»!
Спасибо за невероятный отклик! Ваши вопросы оказались настолько глубокими и нестандартными, что мы с удовольствием их разбирали.
Итак, барабанная дробь 🥁 Екатерина лично выбрала вопрос, который задел её больше всего:
«Техписатель больше не нужен в команде. Кто виноват и что делать?»
Автор этого смелого и острого вопроса — Вера Хаски. Поздравляем! Книга ждёт своего нового владельца.
Но это ещё не всё! Екатерина подготовила видеоответы и на остальные ваши вопросы. Скорее переходите в комментарии к предыдущему посту — вас ждёт много полезного и честного контента. | 1 267 |
| 5 | #книги #интервью #розыгрыш
Всем привет! Сегодня в гостях у Техписалити! — Екатерина Ушакова, автор канала Буквально Ушакова и автор книги
📗"Если ты — технический писатель"
которая вышла этой весной.
• Катя, ты не просто технический писатель, но и преподаватель университета Иннополис. В своих интервью ты делилась, что книга появилась ещё и как методическое пособие для твоих студентов. Расскажи, пожалуйста, какие дисциплины ты преподаёшь и какая литература используется в обучении.
• Я преподаю дисциплину Technical Communication in IT. Мы учим студентов не столько писать документацию по шаблонам, сколько дизайнить коммуникации на разных этапах работы с продуктом. В основе лекций — цикл разработки ПО: мы смотрим, какие коммуникации и артефакты нужны на переходах между этапами, чтобы продукт разрабатывался лучшим образом. Курс более фундаментальный, он много объясняет про коммуникации между разными участниками разработки. Что касается литературы — на английском её много, мы даём студентам список рекомендаций из примерно 40 книг. А вот на русском языке такой литературы почти нет. Книга — это другая история: она про хорошую техписательскую практику. Я хотела, чтобы у нас было больше грамотных коллег, в том числе в плане процессов. Чтобы техписатели не боялись развиваться в смежных областях. Ну и конечно чтобы новички могли для себя понять, кем они будут, когда вырастут. Книга скорее для людей, которые хотят разобраться в профессии самостоятельно.
• Чего не хватало тебе в начале карьеры? Какую книгу ты хотела бы прочитать, когда сама начинала и стала ли эта книга ею?
• Когда я начинала, был Гипербатон, были какие-то видео, книги тоже были — но всё это далеко от продуктового подхода. На старте мне этого хватало. А вот когда я начала нанимать людей и развивать команду, остро не хватало адекватных материалов. Нечего было дать новичку и сказать: «Прочитай, и ты поймёшь, как у нас всё устроено». Так что да, эта книга — во многом та, которой мне самой не хватало.
• Планируешь ли ты выпустить другие пособия, чтобы создать цельный образовательный курс по нашей профессии?
• Есть мысли сделать книгу для старших техписателей и руководителей, но пока не готова назвать точную дату или даже год. Если будет достаточно материала и потребность — да, книги будут. А что касается образовательного курса — у меня есть отдельный проект «Буквально», это курсы для техписателей. Тестовый поток уже прошёл, скоро будут анонсы публичного запуска.
• Можно ли считать, что все, кто прочитает книгу, практически прослушал университетский курс?
• Отчасти. Материал всё-таки разный: в университете больше академичности, фундамента, а в книге больше про быстрый старт уже в компании. Можно прослушать курс и никогда не работать техписом, но нести культуру коммуникаций в своей работе. А можно прочитать книгу и никогда не задумываться о всём цикле разработки ПО. Это два разных пути в профессию, которые дополняют друг друга.
Почти весь тираж разлетелся сразу, но у наших подписчиков есть возможность получить её бесплатно. Задайте вопрос Кате в комментариях. Катя выберет самый интересный вопрос и его автору отправит книгу.
Участвовать может любой, но по традиции, если вы находитесь за пределами России, мы попросим контакты вашего друга или другого доверенного лица в нашей стране. | 1 738 |
| 6 | #какэтоработает #средаразработки
Всем привет! Сегодня продолжим разговор о git, а точнее о двух способах объединения изменений, и посмотрим, для каких ситуаций подходит каждый из них.
git merge VS git rebase
Что делают эти команды?
Git merge объединяет ветки и создаёт отдельный коммит слияния, сохраняя временну́ю последовательность коммитов. Git rebase делает историю линейной, но меняет при этом хэши (уникальные идентификаторы) коммитов.
Рассмотрим, как работает rebase из feature в main. Представим, что до объединения в ветках есть коммиты:
feature: A — B — C (коммит 1 июня)
main: A — B — D (коммит 2 июня)
Что получается после rebase:
feature: A — B — C
main: A — B — C — D' (D' — новый хэш)
Почему смена хэша — это плохо
Коммиты — это “записи”, по которым можно восстанавливать историю или отменять изменения, передвигаясь по ним назад. Rebase переписывает хэши коммитов, чем может сломать историю у других участников процесса.
Чем плох merge?
Если есть изменения, merge добавляет новый коммит с двумя родителями — коммит слияния. Более того, при слиянии сохраняется ветвление, и поэтому сложно визуально определить, какой коммит в одной ветке был сделан раньше, чем коммит в другой.
Что происходит при merge из feature в main?
main: A (коммит, от которого создана ветка) — B — C (коммит 1 июня)
feature: A — E — D (коммит 2 июня)
Что получается после merge в ветке main:
main: A — B — C — F (коммит
\ E — D / слияния)
Когда какой путь выбрать?
Merge или rebase — это выбор между полной историей и визуально чистой историей. Rebase можно использовать, чтобы обновить ветку перед слиянием с основной, сохраняя линейную историю. Merge лучше использовать, если ветка общая и в ней работают несколько разработчиков.
❗️Главное правило: не переписывайте историю, которую уже кто-то мог забрать.
Вопрос к мидлам и сеньорам: а вы используете rebase или обходитесь merge? | 1 101 |
| 7 |  #мемница | 1 250 |
| 8 |  #мемница | 1 434 |
