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

#циталити
Автор цитаты — Арина Балерина

Всем привет!
Нас зовут Лида, Маша и Катя, и мы технические писатели)

Этот пост — навигатор по каналу. Переходите по тегам и читайте то, что вам нужно.

#начало — информация о том, с чего начать.
#колонкаредактора — наши мысли о проблемах профессии. (а тут - грейды)
#выпуск — пошаговый путь в технические писатели. Мы нумеруем выпуски по порядку.
#такбывает — истории из практики.
#вопросвлоб — разбираем частые вопросы, которые звучат на собеседованиях.
#какэтоработает — рассказываем о рабочих процессах.
#практика — практические задания. Помечаем дополнительными тегами, чтобы обозначить область документации.
#пользовательскоеписалити — публикации о создании пользовательской документации.
#личныйОпыт — рассказываем, как сами преодолевали какие-то трудности.
#писалитирекомендует — лучшие практики, методологии или приёмы.
#циталити — полезные цитаты опытных техписателей.
#мемница — рубрика с мемами. Новые знания откроют для вас целый пласт профессионального юмора.
#невыдуманныеистории — интерактивная игра, как устроиться и начать работать техническим писателем.
#средаразработки — рассказываем о терминах в IT, с которыми может столкнуться технический писатель.
#предложка — отвечаем на ваши вопросы.

Впереди ещё много тем и новых рубрик. Учитесь с нами)

#вопросвлоб
Продолжаем разбирать вопросы из собеседований.
Итак, вопрос, который вам зададут с вероятностью в 99,9%:

Почему решили уйти с предыдущего места работы?

Постарайтесь не объяснять свой уход негативом. Как бы вы ни были честны, претендент со скандальным прошлым - не то, что нужно компаниям.

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

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

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

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

Готовьте свой ответ заранее. Это поможет вам быть убедительным и частично избавиться от стресса.

Всем привет! Это сообщение для опытных коллег)

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

30 ноября и 1 декабря пройдёт конференция по управлению знаниями

🔆KnowledgeConf 2023!

Обычно мы слушаем и смотрим про сбор, анализ и использование ценных для бизнеса знаний. Но сегодня предлагаем другое)

🔸Станьте спикером конференции!

Почему мы поддерживаем Костю и KnowledgeConf 2023?

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

💚Понимать ценность своей работы и уметь о ней рассказывать.

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

подавайте доклад здесь: 👉 https://cfp.knowledgeconf.ru/
Там же можно прочитать про сроки, этапы, подробности, условия и всякие плюшки спикерам.

Если есть вопросы или нужна дополнительная информация, смело пишите руководителю Программного комитета Косте Медведеву: @medvedevkonstanteen.

Вперед!❤️

#колонкаредактора
Всем привет!
Мы подготовили пост на важную тему Сколько я стою на рынке труда. Но потом перечитали и поняли, что его можно заменить одной фразой: полистайте hh.ru😏

Поэтому вместо этого поста лучше поделимся, что нам помогает оценивать себя:

- Общение с друзьями-техписами на тему зп,
- Общение в профессиональных сообществах,
- Просмотр того же hh.ru и аналогов,
- Анализ собственной работы,
- Как ни странно - собеседования.

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

#колонкаредактора #грейды
Грейдер технических писателей по версии школы Техписалити!

#колонкаредакторов
Всем привет! Сегодня у нас важная тема:

Грейды технических писателей

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

Как правило, в крупных компаниях есть свои грейды технических писателей. Эти грейды учитывают специфику предметной области и стека технологий. Но что делать, если человек еще не работает в такой компании?

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

Можно ли быть синьором, не зная XML? Да, например, если вы работаете с ГОСТ.
Можно ли, умея писать скрипты на Python, не быть синьором? Да, если вы не способны построить структуру документации.

Мы собрали свой опыт, опыт друзей-техписателей, информацию из других грейдеров и грейдеров смежных областей и подготовили свой упрощенный и унифицированный список грейдов школы Техписалити!

Но это еще не всё)

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

#какэтоработает
Всем привет! А вы замечали, что прежде чем читать, мы сканируем текст? Заголовки, врезки, схемы, картинки, иконки - всё это точки внимания, которые проводят нас по статье.
Задача технического писателя - создать статью, которая приносила бы пользу даже при сканировании, а не только при чтении.

Мы в команде придерживались простых правил в статьях.

1️⃣ Подзаголовки должны отвечать на условный вопрос заголовка. Например:

Как настроить схему работы (заголовок)
- Создайте статусы (подзаголовок)
- Создайте переходы (подзаголовок)
- Настройте правила переходов (подзаголовок).

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

2️⃣ Выделить много - не выделить ничего. Хрестоматийное правило требует аккуратно выбирать визуальные якори. Если выделить мало не получается, например, в тексте часто упоминаются элементы интерфейса, используйте списки или схемы.

3️⃣ Каждому элементу - свой стиль. Если вы используете полужирное начертание, делайте это осознанно. Например, выделяйте только элементы интерфейса. Если вы хотите выделить какую-то мысль, используйте режим примечания. Не забывайте, что слишком выделенный элемент мозг отсекает, как назойливый рекламный макет. Не старайтесь выделить все, помните о правиле №2.

Тестируйте статьи на себе и коллегах при ревью.

#какэтоработает
Всем привет! Вы написали документацию и проверили её с точки зрения языка и стиля. Что происходит дальше?

Тестирование документации

Любую документацию нужно проверить: не вводит ли она пользователей в заблуждение?

🔸Как в идеальном мире

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

🔸Как чаще всего

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

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

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

Помните: если у пользователя будет шанс ошибиться, он ошибётся. Не жалейте своих формулировок, исправляйте, если сомневаетесь в них.

Вычитайте текст снова, избавьтесь от возможных опечаток и ошибок.

Когда документация проверена, публикуйте её. Заканчивается ли на этом её тестирование? Конечно, нет. Встречали в мемах формулировку тестирование на пользователях? Так вот, это не совсем мем.

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

#выпуск 5
Всем привет!
Приглашаем принять участие в небольшом пятничном исследовании.

Это не просто исследование. Мы помогаем одной команде искать технического писателя. Для начала хотели бы проверить, соответствует ли зарплатная вилка ожиданиям. Есть призрачная, но существующая возможность на эту вилку повлиять. Позже мы вернемся с рассказом о вакансии.

Перейдите, пожалуйста, в форму и ответьте на 2 несложных вопроса. При желании можно оставить контакт для обратной связи.