Техписалити! – Telegram
Техписалити!
1.9K subscribers
174 photos
16 videos
89 links
Первая открытая школа технических писателей

Пишут Лида Туляганова, Маша Щеблякова и Катя Марченко
Download Telegram
Всем привет!

В этот четверг, 3 октября, в 19:00 по московскому времени пройдёт митап для технических писателей, организованный коллегами из X5 Tech.

О чём пойдёт речь?

0️⃣ Лютикова Александра из X5 Tech расскажет, как выжить в режиме аврала.
0️⃣ Александр Мачулин из Gram.ax поделится опытом, как они пытались автоматизировать проверки по стайлгайдам.
0️⃣ Акимова Юлия из Яндекс Маркета расскажет, почему дизайнер, UX-редактор и исследователь — единый организм.

1️⃣ Круглый стол «UX-исследования справки и интерфейсов» с коллегами из X5, Cloud.ru, Авито, Яндекс Маркета и Ozon.

Митап будет онлайн и офлайн, а зарегистрироваться и узнать больше о встрече можно по ссылке.

#анонс
Please open Telegram to view this post
VIEW IN TELEGRAM
👍185
#такбывает
Всем привет!
Иногда полезно делиться своими ошибками, даже самыми глупыми, чтобы больше никто их не совершал. А ещё такие истории помогают коллегам избавиться от синдрома самозванца — люди ошибаются, так бывает)

Самая полезная (нет) запись встречи

Для техписателя важно записывать все встречи. Какой бы ни была надёжной память, но в самый ответственный момент и она может подвести. Запись же позволяет сохранить информацию и лишний раз не беспокоить носителя знаний.

Поэтому я (Лида) и решила записать очередную встречу с разработчиком. Но по какой-то причине мой микрофон был программно отключен. И запись получилась такая:

Я: ...
Разработчик: Привет, давай.
Я: ...
Разработчик: Да, верно.
Я: ...
Разработчик: Да.
Я: ...
Разработчик: Да, сейчас это так работает.
Я: ...
Разработчик: Верно.
Я: ...
Разработчик: Хорошо, давай тогда договоримся - во вторник дедлайн.


*Конец записи*

Проверяйте настройки перед записью)
😁50😢24👏9👍7🤝3
😁59💯18🔥6
#колонкаредактора
Всем привет! Продолжаем разговор об особенностях профессии. И сегодня наша тема:

Трамплин в IT или профессия?

Да, действительно, очень часто профессия технического писателя преподносится именно как лёгкий способ присоединиться к IT-сообществу. К техписателю не предъявляются такие требования, как, например, к разработчику или тестировщику: просто пиши и пиши себе текст.

И отчасти это так: знания языков программирования от техписателей требуют не везде.

😎 - Вот освою техписательство и уйду в разработчики!

Но есть ли границы у навыков технического писателя? Можно ли в какой-то момент времени сказать, что "освоил техписательство"?

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

1️⃣ Язык

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

Вашим пользователям всё понятно? Документация помогает использовать продукт? Все процессы доступно зафиксированы? Отлично!

2️⃣ Инструменты

Документация не витает в воздухе — команды передают её заказчику в каком-то виде. Например, в виде страниц в корпоративной вики или в виде распечатанных страниц Word.

Можете ли вы одним махом форматировать все таблицы на 300 страницах текста? Сами создаёте макросы? А может ещё и схемы чертите? Супер!

3️⃣ Управление

Никто лучше технического писателя не знает, как эффективнее рассказать о продукте. Возможно, стоит прекратить передавать бумажки и предложить заказчикам веб-портал, да и вообще нанять ещё одного техписателя, ведь и команда, и продукт давно выросли.

Вы можете выстроить стратегию документации, рассчитать трудозатраты на её реализацию и разработать подробный план? Великолепно!

🧐 - Уже всё? Уже можно уходить в разработчики?

Мы ответим, что уйти можно в любой момент, и вы уйдёте, так и не узнав... Что это ещё не всё)

4️⃣ DocOps

Целый пласт навыков на стыке техписательства, фронтенд-, бэкенд-разработки и DevOps.

5️⃣ Локализация и интернационализация

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

😏 — Оу, здесь уже и платят неплохо, и код писать могу, и зачем мне тогда в разработчики?

Техписатель — не просто трамплин в IT, а самая настоящая профессия. И, если для вас это важно, у неё есть свой госстандарт. Оставайтесь с нами❤️
Please open Telegram to view this post
VIEW IN TELEGRAM
30🔥9👌4🤝1
А вы в техническом писательстве временно или надолго?
Anonymous Poll
12%
Я на трамплине
68%
Я техписатель
19%
Мне только посмотреть😊
4🔥3🥰2👍1💯1
😁62💯11👻2👎1
😍35😁25🤡3💯3
#колонкаредактора
Всем привет! "Где учиться на техписателя?" — самый частый вопрос от новичков. Это важный вопрос, но мы предлагаем начать с другого: как учиться на техписателя?

Самообразование, курсы, менторы — три уровня образования

Почему мы рекомендуем выстроить обучение именно так? Рассказываем.

1️⃣ Самообразование

Новички всегда в поисках курсов. Кажется, что появится школа, которая всему научит. Но техническая документация — очень широкое понятие. Ни одни курсы не принесут вам пользы, если не знать, что именно вы хотите изучить.

Поэтому, прежде чем искать курсы, мы советуем поучиться самостоятельно. Это позволит вам точно понимать, что искать дальше.

Всем новичкам мы предлагаем:
*️⃣Посмотреть курс на ютуб от Документата,
*️⃣Почитать редполитики, например, редполитику Госуслуг,
*️⃣Почитать книгу Кагарлицкого (ссылку дали как пример, что-то цена там неконкурентная),
*️⃣Подписаться на нас и почитать посты с начала 😊

2️⃣ Курсы

Курсы, которые испытаны нами лично, посоветовать не получится, потому что они не вынесли испытание временем, хотя были очень хороши.

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

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

3️⃣ Менторы

Кто такие менторы? Это опытные технические писатели, которые за деньги (от 2 000 рублей за час) помогут вам решить конкретные задачи в обучении. Например, они могут выстроить индивидуальный план обучения, исходя их ваших знаний, либо поделиться знаниями в конкретной области.

Некоторые менторы могут помочь вам в устройстве на работу: например, порекомендовать вас своим знакомым-нанимателям. Но вы должны понимать, что рекомендаций мало и вы сами должны суметь пройти отбор.

И тут мы снова возвращаемся к пункту 1 😉
Самообразование — основа всего обучения.

🔆 Если вы уже прошли какой-то хороший курс или нашли хорошую публикацию, поделитесь, пожалуйста, ссылкой на них в комментариях.

Также вы можете оставить ссылку на свой канал или курс, если они посвящены технической документации.

Давайте соберем для новичков полезную информацию
.
Please open Telegram to view this post
VIEW IN TELEGRAM
283🤓3👍2🤷1
😁48💯21💔54
💯57😁9😢6
❤‍🔥47👍19💯9
🤣69😁19💯12
#писалитирекомендует

Всем привет!
И в том числе привет всем новеньким подписчикам❤️

Мы решили помочь вам выжать максимум из нашего канала. Будем публиковать дайджесты с ранними постами, которые могут быть интересны в свете обсуждений в сообществе, например, в жёлтом чате.

Итак, популярная тема на этой неделе — грейды техписателей.

У нас по этой теме:

1️⃣ Грейды технических писателей: примерная лестница для новичков и бесплатная основа для вашего ранжирования. Забирайте и подстраивайте под себя)

2️⃣ Чем сеньор отличается от джуна? Размышления у парадного подъезда)

3️⃣ Что делать джуну, если лид ушёл в отпуск? Наши рекомендации, или чего мы ждали от своих джунов

Учитесь вместе с нами❤️
Please open Telegram to view this post
VIEW IN TELEGRAM
👍2013
Всем привет!

Сегодня, 14 ноября, в 19:00 по московскому времени пройдёт митап для технических писателей, организованный коллегами из Cloud․ru.

О чём пойдёт речь?

🔴 Юлия Служаева из Cloud․ru расскажет о редполитике: как написать правила и не устроить бои без правил.

🔵 Марина Смирнова и Екатерина Каляева из Cloud․ru поделятся, как они автоматизировали проверку документации: кейс с линтером Vale.

🟢 Антон Литвинов из SberDevices поговорит о системе метрик клиентской документации.

🟠 Теодора Малевинская из T-Bank расскажет о частых ошибках техписателей в поиске работы.

Ссылка на онлайн-трансляцию появится в канале TeamSnack TechWriters, не пропустите :)

#анонс
Please open Telegram to view this post
VIEW IN TELEGRAM
168
😁395
#вопросвлоб

Всем привет! Несмотря на предновогоднее затишье на рынке труда, продолжаем рассказывать о частых вопросах на собеседованиях. И сегодня у нас вопрос:

Что такое синхрофазотрон?

Нет-нет, мы не будем говорить о синхрофазотроне)

Иногда рекрутеры просят у кандидатов ссылки на документацию с прошлой работы — примеры текстов. По умолчанию подразумевается, что хороший технический писатель знает, о чём пишет.

Так вот в вопросе "Что такое...?" вместо синхрофазотрона может оказаться любой термин из вашей документации. Например, что такое динамическая маршрутизация?

Конечно, вы не обязаны владеть предметной областью на 100%, но лучше продемонстрировать хотя бы общее понимание термина. Выжтехписатель, и выбор слов для документации должен быть осознанным.

Действующие техписатели, ставьте 👍, если знакомы со всеми терминами в вашей доке😉
👍30🔥9😭8
💯26😭1410
#анонс

Всем привет!

Несём вам отличную новость:

Почти через две недели, 10 декабря, в 19:00 по московскому времени пройдёт митап для технических и UX-писателей — уже шестой Techdoc Meetup, в этот раз организованный коллегами из Ozon!

О чём пойдёт речь?

🟡 Анастасия Писнова из Ozon поделится опытом работы с текстом как с проектом.
🟡 Светлана Каюшина из СберТех расскажет, какую пользу ИИ может принести техписателям.
🟡 Павел Костромитин из Т-Банка расскажет о росте команды UX-редакторов и их роли в ренейминге.

🟢 А на круглом столе можно будет обсудить компетенции продуктовых техписателей вместе с коллегами из Ozon, Т-Банка, X5 Tech и VK.

Митап будет проходить онлайн и офлайн, и запись тоже будет 🎞
Зарегистрироваться и узнать о мероприятии больше можно по ссылке.
17🔥10
#мемница

Я — техпис, во мне сто лиц!
🤣42💯308🔥8
#анонс

Всем привет!

Всего через несколько часов у ITRadio в гостях будет Карен Товмасян (Senior Engineer в Payments @ Uber и автор канала Человек и Машина). Говорить будут о том:

🔹 как писать слово «инцидент»
🔹 чем отличается инцидент от аварии, алёрта или бага
🔹 что происходит в процессе починки, чем postmortem отличается от обычного отчёта об аварии.

Ещё и офигительных историй на десерт обещают!

Трансляция будет здесь и тут сегодня, 29.11.2024, в 17:00 по московскому времени.

Подробнее о подкасте читайте на сайте и канале ITRadio.
(А ещё там можно вопросы задавать!)
🔥74