Техписалити!
1.97K subscribers
178 photos
30 videos
97 links
Первая открытая школа технических писателей

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

Мы снова с новостями для студентов🧑‍🎓

Хотите прокачать скиллы технического писателя и научиться превращать сложные технологии в понятные тексты? Вперёд на стажировку в Kaspersky! Доступно для студентов невыпускного курса любых вузов в Москве и Московской области.

В одной лодке с профессионалами Kaspersky можно научиться:

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

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

Переходите по ссылке https://kas.pr/c4x2 и подавайте заявку на направление Technical Writing🖥✍️
🔥125
#колонкаредакторов
Всем привет!
Возможно, вы заметили, что в нашем канале некоторое затишье. Современные события немного подкинули нам поводов подумать)

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

Поэтому мы переходим в Макс.

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

Поскольку мы остаёмся в телеграме, предлагаем посмотреть залипательное – атлас телеграм-каналов, в котором есть и мы, и многие наши дружественные блоги.

Давайте найдём их все! А начнём отсюда)
36🔥7👀4👨‍💻3
Media is too big
VIEW IN TELEGRAM
#twd3
Всем привет! 27-28 марта в Москве прошла третья международная конференция технических писателей TechWriterDays, и мы по традиции делимся собственным взглядом на конференцию.

*️⃣Самый объёмный сектор знаний:
- Применение искусственного интеллекта.

*️⃣Самая востребованная тема:
- Уровни качества документирования и зрелость процессов.

*️⃣"Волшебная таблетка":
- Пакет шаблонов и матрица компетенций от Александры Базуткиной из RWB для управления коллективом из 100+ сотрудников.

*️⃣Самая неожиданная тема:
- Сертификация технических писателей и компаний.

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

Оставляем ссылки на доклады, которые официально получили наивысшие оценки от слушателей:

1️⃣ Наталья Борисенко "Документация как продукт: от текстов к стратегии и управлению опытом"
2️⃣
Камила Мазаева "Кому доверить ревью API — техпису или искусственному интеллекту"
3️⃣
Никита Авилов "Сам себе редактор: ИИ для вычитки текста и локализации"

В течение года в официальном канале конференции будут публиковаться видеозаписи этих докладов. Рекомендуем посмотреть, и чтобы вы их не пропустили, обязательно опубликуем ссылки на записи.
Please open Telegram to view this post
VIEW IN TELEGRAM
1❤‍🔥264👍4
#колонкаредакторов
#вопросвлоб

Всем привет! На связи Лида. Сегодня у нас с вами серьёзный разговор. Как и намекает рубрика — о собеседованиях.

Адвокат для соискателя

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

Если ведётся запись, то кандидата спрашивают: "Вы не против?" — этого требует закон. Записывать человека в непубличном месте без его согласия никто не имеет права.

Но если на встрече присутствует участник вроде "HR-AI", у кандидата никто не спрашивает разрешения. А ведь это ещё одно техническое устройство, которое не просто транскрибирует видео, но и даёт анализ навыков и личности кандидата. Припоминаю, что на психологическое исследование человек тоже должен давать разрешение.

Кажется, будто трудовой кодекс серьёзно отстаёт от действительности. И по факту, ИИ-исследования, проводимые без согласия, нарушают права кандидата.
Ещё один момент. На собеседование кандидат приходит один. А на другой стороне — рекрутер, технический специалист, возможно, даже тимлид и ещё и ИИ-агент. Извините, но даже у обвиняемого в суде есть адвокат. А тут человек сидит, как перед экзаменационной комиссией. Хотя собеседование — это не экзамен, это переговоры равноправных сторон.

Мне представляется, что кандидат может прийти со своим hr-агентом и ИИ-агентом. Это было бы справедливо. И по итогу провести анализ знаний, умений и особенностей личности всех собеседующих. Узнать степень их доброжелательности или, наоборот, токсичности. Сравнить сказанное ими о компании с информацией из открытых источников.

Да, это всё розовые фантазии. Но ведь это было бы справедливо, не так ли?
👍35🔥20💯17🙏52🤯2
#какэтоработает  #вопросвлоб

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

Как выкатить документацию на другом языке, если у вас нет ни времени, ни ресурсов

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

Сразу оговоримся, что подобный подход — это способ потушить пожар, а не выстроить систему правильно.

Подготавливаемся

1️⃣ Узнайте, на сколько языков нужно перевести документацию.
2️⃣ Узнайте, в каких странах вы должны выйти, нужны ли вам домены в этой стране.
3️⃣ Изучите требования законодательства относительно данных в этих странах. Например, нужно ли разворачивать сервис документации на мощностях местных ЦОДов.
4️⃣ Запросите требования вашей службы информационной безопасности.
5️⃣ Уточните, все ли сервисы вашего продукта локализованы в нужных странах. От этого зависит, все ли функциональности будут доступны в этой стране. Если не все, готовьтесь скрывать часть документации.

Заручаемся поддержкой

6️⃣ Возьмите у команды продукта переводы текстов интерфейса.
7️⃣ В условиях сжатых сроков и отсутствия ресурсов мы будем использовать искусственный перевод. Расскажите владельцу продукта о ваших планах, аргументируйте каждое решение. Владелец продукта и менеджер продукта должны быть вашими союзниками, используйте свой талант переговорщика.

Работаем с текстами

8️⃣ Приготовьте на основе переводов словари значений русский — иностранный, столько пар, сколько языков. Эти словари вы сможете использовать в качестве контекста для искусственного перевода. (Помним, что у нас нет времени и ресурсов, поэтому ИИ — наш выход).
9️⃣ Если вам требуются нераспространённые языки, сформируйте словари английский — иностранный. Если у вас изначально есть английская документация, ИИ с английского на редкие языки порой переводит лучше, чем с русского.
1️⃣0️⃣ Подготовьте иноязычные исходники в нужной вам разметке. Загрузите в ИИ в качестве контекста наши словари и с помощью промпта запросите перевод. В идеале лучше настроить интеграцию с системами построчного перевода, но мы помним, что у нас нет времени и ресурсов. Вы можете использовать агенты и прописывать им правила — в этом случае перевод может быть лучше.

Строим, собираем, разворачиваем, тестируем

1️⃣1️⃣ Проработайте архитектуру документации и процессы, которые позволят разворачивать документацию в нужных конфигурациях и на нужных адресах. Это может быть непростой работой и занять приличное количество времени. Если у вас есть помощники-девопсы, вам повезло.
1️⃣2️⃣ Если у вас в продукте есть нелокализованные сервисы, подготовьте скрипты, которые позволят скрывать описания конкретных функциональностей в конкретных странах (на конкретных доменах). Если вы не умеете это делать, вам могут это рассказать наши ИИшные друзья. Для них это несложно, и они в этом практически не ошибаются.
1️⃣3️⃣ Если вы поставляете публичную документацию, позаботьтесь о том, чтобы поисковые системы правильно проиндексировали её. Для этого снабдите страницы нужными метаданными.
1️⃣4️⃣ Протестируйте сборку и развёртывание документации в тестовых окружениях.

Публикуем

1️⃣5️⃣ Получите согласование от владельца и менеджера продукта и опубликуйте документацию. И да поможет вам бог.

Можно ли поддерживать такую документацию в актуальном состоянии? — Да, если реализовать непрерывную локализацию, о которой мы расскажем в других постах.
10😁3🙏3🙉3🔥1🌚1🖕1