Size: a a a

Технические писатели

2021 November 27

VI

Vladimir Izmalkov in Технические писатели
Я вроде четко сформулировал мысль. Я не против, если стажёр вырастет из техписов в кого-то ещё потом, но я этого не добиваюсь. Просто работа у нас полна технических деталей в которых надо разбираться.
источник

VI

Vladimir Izmalkov in Технические писатели
Программировать при этом не нужно, но пишем документацию для админов, программистов и инженеров по сути. Надо стараться писать понятно для целевой аудитории. На их языке (если вы простите меня за чей штамп).
источник

SR

Stas Rychkov in Технические писатели
Владимир, так ведь "сложные сущности" конечно коррелируют с "базовыми принципами". Но корреляция двух процессов не означает их причинно-следственную связь. Я больше про это. Не хотите поменять оригинальную формулировку?

Кажется, что она потенциально блокирует того самого начинающего от того, чтобы начать у вас. А вы теряете потенциально качественные кадры.

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

Задайте, например, своим старшим писателям вопрос: "в чём отличия уровней L1, L2, L3"? Как вы знаете, это тоже про принципы софта.
источник

VI

Vladimir Izmalkov in Технические писатели
Нет, формулировка в точности доносит смысл ожидаемого от кандидата. Я честно предупреждаю, на что буду смотреть. Даже пояснил почему считаю отсутствие некоторого опыта (даже самостоятельного) одним из красных флагов.
К сожалению, практически все кандидаты утверждают, что им интересно развиваться в IT, но далеко не у всех это потом выходит.
Как я и сказал, это лишь мой опыт, к тому же весьма специфичный для нашего отдела. Многим другим он может не подходить, я и не претендую. Но искать дарование среди кандидатов, ничего не попробовавших сделать самостоятельно (just for fun хотя бы) по моему опыту для нашей ситуации - не эффективно. Велика вероятность, что человек нам не подойдёт по своим интересам и складу ума, а узнаем мы об этом где то через полгода после найма. И то бывают сомнения.
источник

BL

Bo Larson in Технические писатели
Вообще убрать
источник

BL

Bo Larson in Технические писатели
Доброго времени суток, брррр
источник

SR

Stas Rychkov in Технические писатели
Друзья, завязывайте с негативными откликами по опубликованному резюме.

Едва ли кто часто отваживается публиковать здесь своё резюме. Постарайтесь поставить себя на место новичка.

Если есть что сказать, помогите советом, а лучше покажите, как надо.

Здесь было несколько хороших советов. Спасибо тем, кто нашёл время их оставить.

Опыт -- это про помощь.
источник

KY

Ksenia Yakushina in Технические писатели
к любому резюме можно прикопаться так-то. идеала не существует.
источник

G

Grolribasi in Технические писатели
А что значит p*##ies?
источник

EZ

Ekaterina Zakharova in Технические писатели
Я бы еще обратила внимание на оформление библиографического списка.
Отдельный вопрос - как часто подобное появляется в документации?
источник

SR

Stas Rychkov in Технические писатели
Это лишнее слово. Убрал. :)
источник

SR

Stas Rychkov in Технические писатели
Возможно, Дарья пыталась оформить материал как статью. Так иногда делают на Medium, например. В руководствах действительно библиографический список не вставляют. Хорошо, что вы отметили этот момент.
источник

LT

Lidia Tulyaganova in Технические писатели
Гост 2 и еще какой-то требует, это доки на исследования
источник

ВЩ

Владимир Щепин... in Технические писатели
Привет. Работу не ищу, но есть вопрос. Скорее всего, он в том или ином виде задавался уже, т.к. чятик-то профильный.

Где можно найти релевантный опыт в отсутствии релевантного опыта? Никогда активно не думал про а-не-попробоваться-ли-техписом, но почему бы нет в какой-то перспективе.. В конце концов, я писать/читать люблю, на месте мозги и руки, личную б/з стараюсь вести, да и во внутреннюю проектную изредка что-то можно (но это не мой профиль и не моя задача).

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

L

Luiza in Технические писатели
А в текущем рабочем процессе навыки письма ведь наверняка можно применить
источник

ВЩ

Владимир Щепин... in Технические писатели
Можно, и применяю: к примеру, привил себе привычку фиксировать новую инфу в заметочнике. Чем-то иногда делюсь с коллегами. Но по большому счету в рабочее время голова забита другими задачами. Я хотел что-то сделать с внутреннец вики, там местами беспорядок, но глобально руки дойдут вряд ли ранее чем месяца через 2-3.

Короче, хотелось бы другого контекста. :)
источник

V

Vasiliy in Технические писатели
Если на русском, то есть, например русский аналог MDN https://doka.guide/
источник

V

Vasiliy in Технические писатели
А так, конечно, все большие опенсорс проекты на английском. Можно начать с документации для тех продуктов и инструментов, которыми сами пользуетесь и в которых разбираетесь.
Иногда по задачам на том же гитхабе не совсем понятно, с чего можно начать. Тут будет большим плюсом, если у проекта есть более менее постоянная команда контрибьюторов в доку и они общаются на встречах или в слаке. Там можно обсудить насущные проблемы и направления развития, в которые можно влиться.

По англоязыным проектам, которым требуется помощь с документацией,  можно ещё спросить в сообществе Write The Docs  https://www.writethedocs.org/slack/
источник
2021 November 28

SR

Stas Rychkov in Технические писатели
Всем привет. Наткнулся на отличную интерактивную презентацию Райффайзенбанка о тексте в интерфейсах. Отлично сделано, и кажется, что её суть никуда не исчезает для любых текстов.

Не помню, проскакивала ли она у нас. Александре Вельяниновой поклон за такую отличную вещь.

https://www.figma.com/proto/0JyAj15IhSa3cnf4tl2vmr/Raiffeisen-Verbal-Guide?page-id=15722%3A39022&node-id=15825%3A39622&viewport=880%2C327%2C0.10488536208868027&scaling=scale-down

#презентация #guide #presentation #ui #ux
источник

АП

Александр Парень... in Технические писатели
Просто огонь. Добавил себе в мемориз.
источник