Size: a a a

technicalwriters

2020 May 29

L

Liudmila in technicalwriters
ritfest.ru
Семён Факторович на РИТ++ 2020
Все мы сходимся на том, что документация — это хорошо и полезно.Как написать документацию так, чтобы она на самом деле была хорошей и полезной — очень сложный и многогранный вопрос. Чтобы подойти к ответу на него, нужно задуматься о двух вещах: кому мы пишем документацию и зачем мы ее пишем. Другими словами, написание документации (как и любую другую проектную активность) нужно начать с ее целеполагания. На этом мастер-классе мы поговорим вот о чем:- С каких сторон нужно изучить вашу проектную ситуацию, чтобы понять, какая документация вам нужна?- Как идентифицировать читателей документации и понять их нужды?- Как писать документацию, чтобы она максимально хорошо решала задачи читателей?- Как писать документацию, чтобы она максимально хорошо решала задачи бизнеса?В первой части мастер-класса я расскажу, как мы отвечали на эти вопросы в проектах, в которых я участвовал в последние 8-9 лет.Во второй части мастер-класса мы будем рассматривать проектные ситуации, случавшиеся у вас (т.е. участников мастер-класса)…
источник

FM

Fox Mulder in technicalwriters
Мы их отстреливаем, отстреливаем, а они всё лезу и лезут!
источник

L

Liudmila in technicalwriters
Fox Mulder
Мы их отстреливаем, отстреливаем, а они всё лезу и лезут!
кого? техписов?
источник

S

SystemA in technicalwriters
Liudmila
кого? техписов?
Факторовичей?!
источник

АЦ

Алена Цыкина... in technicalwriters
Kseniya Chudakova
Ребята, подскажите кейсы описания структуры БД, примерчики и всё такое. Ещё ни разу не доводилось, хочется наступить на меньшее количество грабель.
Ребята, присоединяюсь к просьбе)
источник

L

Lana in technicalwriters
Алексей Хорьков
Что-то у нас опять резкий прирост) признавайтесь, кто на каком мероприятии группу попиарил?)
ну на лекции наверняка сегодня тоже
источник

IC

Ivan Cheban in technicalwriters
Kseniya Chudakova
Ребята, подскажите кейсы описания структуры БД, примерчики и всё такое. Ещё ни разу не доводилось, хочется наступить на меньшее количество грабель.
Все начинается с ERD — entity relationship diagram. Там где PK, FK (primary key, foreign key). Ну, а потом все сводится к data dictionary — описание типа данных, примеров.
источник

IC

Ivan Cheban in technicalwriters
Мне всегда было интересно, почему эту задачу вешают на техрайтеров.
источник

S

SystemA in technicalwriters
Всем не угодишь

Сокращаешь текст — убиваешь язык.

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

Используешь феминитивы — уродуешь язык.

Не используешь феминитивы — душишь язык, мешаешь естественному развитию, каким-то образом подавляешь женщин.

Используешь заимствованные слова — уродуешь язык.

Не используешь — мешаешь прогрессу.

Пишешь с ё — старообрядец, как для детей пишешь.

Пишешь без ё — обедняешь язык.

Транслитерируешь — садист.

Используешь латиницу — шпион, предатель.

Пишешь полезный контент — не учите нас жить.

Пишешь развлекательный контент — вы воруете наше время и внимание.

Спрашиваешь мнение читателя — это обман, чтобы набрать классы.

Не спрашиваешь — корона жмет.

Вообще ничего не пишешь — плохой автор.

Много пишешь — графоман.

Запускаешь платную рассылку — инфобизнесмен.

Запускаешь бесплатную рассылку — дешевка.

Не позвали на конференцию — неудачник.

Позвали на конференцию — балабол.

Организовал конференцию — неудачник, который собрал балаболов.

Пошел на конференцию — бездельник, который слушает балаболов.

Не пошел на конференцию — не занимаешься саморазвитием.

Занимаешься саморазвитием — бездельник, лучше бы работал.

Работаешь — лучше бы занялся семьей.

Занимаешься семьей — а карьеру кто будет строить?

Так и живем!
источник

FM

Fox Mulder in technicalwriters
класс!
источник
2020 May 30

Ю

Юлия in technicalwriters
Адски плюсую!😁
источник

CD

Constantine Drozdov in technicalwriters
SystemA
Всем не угодишь

Сокращаешь текст — убиваешь язык.

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

Используешь феминитивы — уродуешь язык.

Не используешь феминитивы — душишь язык, мешаешь естественному развитию, каким-то образом подавляешь женщин.

Используешь заимствованные слова — уродуешь язык.

Не используешь — мешаешь прогрессу.

Пишешь с ё — старообрядец, как для детей пишешь.

Пишешь без ё — обедняешь язык.

Транслитерируешь — садист.

Используешь латиницу — шпион, предатель.

Пишешь полезный контент — не учите нас жить.

Пишешь развлекательный контент — вы воруете наше время и внимание.

Спрашиваешь мнение читателя — это обман, чтобы набрать классы.

Не спрашиваешь — корона жмет.

Вообще ничего не пишешь — плохой автор.

Много пишешь — графоман.

Запускаешь платную рассылку — инфобизнесмен.

Запускаешь бесплатную рассылку — дешевка.

Не позвали на конференцию — неудачник.

Позвали на конференцию — балабол.

Организовал конференцию — неудачник, который собрал балаболов.

Пошел на конференцию — бездельник, который слушает балаболов.

Не пошел на конференцию — не занимаешься саморазвитием.

Занимаешься саморазвитием — бездельник, лучше бы работал.

Работаешь — лучше бы занялся семьей.

Занимаешься семьей — а карьеру кто будет строить?

Так и живем!
нужен опрос по каждому из пунктов!
источник

A

Andrey in technicalwriters
Kseniya Chudakova
Ребята, подскажите кейсы описания структуры БД, примерчики и всё такое. Ещё ни разу не доводилось, хочется наступить на меньшее количество грабель.
Посмотрите в гугле примеры  по запросу Logical data model, там более-менее хорошо все расписано, примеров под рукой к сожалению нет
источник

KC

Kseniya Chudakova in technicalwriters
Andrey
Посмотрите в гугле примеры  по запросу Logical data model, там более-менее хорошо все расписано, примеров под рукой к сожалению нет
Спасибо
источник

ОS

Олег SoftFAN in technicalwriters
SystemA
Всем не угодишь

Сокращаешь текст — убиваешь язык.

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

Используешь феминитивы — уродуешь язык.

Не используешь феминитивы — душишь язык, мешаешь естественному развитию, каким-то образом подавляешь женщин.

Используешь заимствованные слова — уродуешь язык.

Не используешь — мешаешь прогрессу.

Пишешь с ё — старообрядец, как для детей пишешь.

Пишешь без ё — обедняешь язык.

Транслитерируешь — садист.

Используешь латиницу — шпион, предатель.

Пишешь полезный контент — не учите нас жить.

Пишешь развлекательный контент — вы воруете наше время и внимание.

Спрашиваешь мнение читателя — это обман, чтобы набрать классы.

Не спрашиваешь — корона жмет.

Вообще ничего не пишешь — плохой автор.

Много пишешь — графоман.

Запускаешь платную рассылку — инфобизнесмен.

Запускаешь бесплатную рассылку — дешевка.

Не позвали на конференцию — неудачник.

Позвали на конференцию — балабол.

Организовал конференцию — неудачник, который собрал балаболов.

Пошел на конференцию — бездельник, который слушает балаболов.

Не пошел на конференцию — не занимаешься саморазвитием.

Занимаешься саморазвитием — бездельник, лучше бы работал.

Работаешь — лучше бы занялся семьей.

Занимаешься семьей — а карьеру кто будет строить?

Так и живем!
источник
2020 June 01

AS

Al Sku in technicalwriters
Привет. А накидайте примеры модных туториалов по началу работы. Желательно те, которые встроены прямо в программу. Т.е. открываешь первый раз, и тебе за ручку все основное показывают. Всем заранее спасибо.
источник

AD

Alyona Devon in technicalwriters
Привет, а можете посоветовать какую-то литературу на русском про грамотный UX райтинг (подпись кнопок, уведомлений и прочее в интерфейсе)

я вот нашла только на английском пару статьей и книжку microcopy + был опыт общения с клиентами в поддержке 3 года (как пользоваться продуктом; делать интеграции, добавить что-то на сайт и прочее)
ну и просто гайды и документацию пишу 2 года, навык письма имеется

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

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

NK

Nata Kazakova in technicalwriters
https://vc.ru/design/67419-pridumat-prostye-i-ponyatnye-nazvaniya-komand-dlya-interfeysa-pravila-napisaniya-horoshego-ui-teksta

может подойдет хотя бы эта статья :) в шапке ссылка на оригинал на англ
источник

NK

Nata Kazakova in technicalwriters
как хорошо, что мы должны писать понятно, а не на юридическом)) я секунд 15 искала тут глагол
источник

S

Sylvestr in technicalwriters
Nata Kazakova
как хорошо, что мы должны писать понятно, а не на юридическом)) я секунд 15 искала тут глагол
Вы когда-нибудь писали формулы для изобретений?
источник