Size: a a a

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

2021 September 23

AD

Alyona Devon in Технические писатели
Джулия Эванс, регулярный гость в нашем уютном бложике, но на этот раз не с своими прекрасными Зинами Для Программистов, а с перечнем так-себе-паттернов затрудняющих восприятие информации и кайфовые примеры к ним.

💥паттерн 1: делать устаревшие предположения об знаниях аудитории
💥паттерн 2: наличие противоречивых ожиданий относительно знаний читателя
💥паттерн 3: натянутые аналогии
💥паттерн 4: забавные иллюстрации на сухих объяснениях
💥паттерн 5: нереалистичные примеры
💥паттерн 6: жаргон, который ничего не значит
💥паттерн 7: отсутствует ключевая информация
💥паттерн 8: вводится слишком много концепций одновременно
💥паттерн 9: начинаете абстрактно
💥паттерн 10: неподдерживаемые ничем утверждения
💥паттерн 11: нет примеров
💥паттерн 12: объяснять «неправильный» способ сделать что-то, не говоря, что это неправильно
💥паттерн 13: «что» без «почему»

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

🔗 Читать: Patterns in confusing explanations
источник

А

Алексей in Технические писатели
Спасибо за рекомендацию!
источник

НО

Наталья Орлова... in Технические писатели
И любимый ролик https://www.youtube.com/watch?v=cDA3_5982h8
источник

Y

Yula in Технические писатели
в этом видео прекрасно всё 😇🔥
источник

НО

Наталья Орлова... in Технические писатели
Я его каждый раз вспоминаю, когда ПМИ пишу. ;-)
источник

N

Nadia in Технические писатели
😆 Какие терпеливые дети
источник

M

Maeg in Технические писатели
Ура, меня разбанили, спасибо! Поэтому!
#tw_wanted #wanted_tw #вакансия #удалённо
Ищу себе коллегу. Нужен обычный техпис: писать на русском, понимать английский, разбираться в сложной системе, лопатить тонны чужого наследия, на ручках переносить контент из H&M в rst и далее это поддерживать. Если человек съел собаку на gettext - готова уступить свою лидирующую позицию в группе техписов, если нет - будем разбираться вместе :) Но всё же самое главное - хороший русский язык и умение структурировать документацию, поэтому обязательно будет тестовое задание (именно его наличием объясняют то, что мы уже месяц не можем найти человека, но извините, без тестового задания я никому не верю).
Официальное описание вакансии - https://novosibirsk.hh.ru/vacancy/47227180. Про зарплату и официальное - по контактам в описании вакансии или эйчару @Anya_Giraffe. С неофициальными вопросами - ко мне в личку.
источник

FM

Fox Mulder in Технические писатели
А портфолио на GitHub с контрибьютом в OpenSource уже не вариант? )
источник

NV

Nick Volynkin in Технические писатели
Gettext простой, я тебе его за полчаса расскажу, чтоб ты не рисковала троном )
источник

M

Maeg in Технические писатели
о, это совсем для взрослых. Ранее я сталкивалась с вордовыми документами в портфорлио, где "мы пахали: я и трактор" - то есть да, человек участвовал в разработке, но в одиночку сделать структуру или написать интерлюдию не способен
источник

M

Maeg in Технические писатели
я сделала один подход, и мне стало страшнно :) Но это задача уже на ноябрь - за это время как раз новый техпис должен въехать в систему, а мы как раз выкатим MVP на английском
источник

ME

Maria Ermakovich in Технические писатели
интерлюдия для меня звучит как что-то из космооперы
источник

M

Maeg in Технические писатели
ок, вводная часть статьи :)
источник

VB

Vitaly Belyakov in Технические писатели
извините, а под H&M что имеется в виду? Я только сеть магазинов с таким названием знаю)
источник

AY

Andrei Yemelianov in Технические писатели
Help and Manual
источник

M

Maeg in Технические писатели
Help&Manual. Хороший инструмент. Был. Когда-то. WYSIWYG, XML. Хреновое совместное редактирование через SVN
источник

VB

Vitaly Belyakov in Технические писатели
Ясно, спасибо)
источник

rK

rJIynbIu` KOT in Технические писатели
откликнулся на hh
источник

ГН

Геннадий Н in Технические писатели
+1)
источник

LT

Lidia Tulyaganova in Технические писатели
фраза "тонны чужого наследия на ручках переносить из H&M" приобрела новый смысл))))
источник