Size: a a a

2019 November 20

Е

Екатерина in technicalwriters
Думаю стоит отталкиваться от цели этого человека. Обычно если нужно объяснить другому человеку важность чего-либо,  нужно чтобы это коснулось его непосредственно, было важно для его цели.
источник

SR

Stas Rychkov in technicalwriters
Nick Volynkin
Человек с нулевым бэкграундом в Computer Science может и не знать про True/False.
А трюк именно в том, чтобы он и дальше не знал.

Ему нужно знать, что без документации может сломаться. Это риск. Корневой причиной будет как раз отсутствие документа.
источник

СФ

Семён Факторович in technicalwriters
Lana
отправка письма на почте, письмо нужно подписать, указать адрес (эндпойнт) и все элементы адреса, город, улица, квартира, индекс (обязательные параметры), способ отправки (аналогия с методом), наклеить марку с нужной ценой и в нужный угол конверта, иногда - описать содержимое (тело запроса), еще иногда письма бывают с уведомлением о вручении (ответ сервера), все эти правила - такой же контракт, не написал индекс или не знаешь его - письмо будет идти дольше или не дойдет вовсе, также, если у адресата поменялся адрес или цена марки до пункта назначения - а ты не знаешь об этом, писбмо не дойдет
этот вариант такой классный, что ты скорее всего придумала его уже давно и неоднократно отшлифовывала?:)
источник

L

Lana in technicalwriters
Семён Факторович
этот вариант такой классный, что ты скорее всего придумала его уже давно и неоднократно отшлифовывала?:)
Эх если бы, экспромт
источник

СХ

Саша Хо in technicalwriters
Кстати, посылки и письма действительно хорошо подходят для объяснения работы некоторых ИТ-технологий. Я в одном тестовом пыталась объяснить принцип работы TLS на примере отправки ценного подарка в другой город.

Но это работает, если человек былна почте и отправлял/получал письма и посылки.
источник

DS

Daria Savina in technicalwriters
Мне, помню, на примере иностранных языков объясняли. Ты знаешь, что хочешь сказать, но тебе надо знать, как это сказать. И мочь понять, что тебе ответили. Но это не очень гибкий вариант
источник

S

Sara in technicalwriters
Семён Факторович
этот вариант такой классный, что ты скорее всего придумала его уже давно и неоднократно отшлифовывала?:)
вообще идея с документирвоанием API очень хорошо становится понятна при взгляде на хорошую документацию API. Я, когда еще не особо понимала, что такое API в целом, получила довольно хорошее понимание, как только пришлось посмотреть на хорошую доку
источник

Е

Екатерина in technicalwriters
Можно примеры хороших док?
источник

S

Sara in technicalwriters
Екатерина
Можно примеры хороших док?
те, на которых у меня случилось озарение, закрытые, распространяются вроде только контрагентам
источник

Е

Екатерина in technicalwriters
Окей😥😀
источник

S

Sara in technicalwriters
Екатерина
Окей😥😀
а не, раскрыли )
источник

S

Sara in technicalwriters
источник

S

Sara in technicalwriters
но эт уже не то, раньше было понятнее будто
источник

Е

Екатерина in technicalwriters
Супер! Спасибо
источник

Е

Екатерина in technicalwriters
Посмотрим
источник

S

Sara in technicalwriters
я это видела в форме pdf доки. Примитивно, но было очень все ясно и ничего лишнего
источник

SR

Stas Rychkov in technicalwriters
Indefinite article with plurals?
источник

SR

Stas Rychkov in technicalwriters
A variables?
источник

НН

Нац Нац in technicalwriters
Всем пофиг на артикли
источник

ME

Maria Ermakovich in technicalwriters
Нац Нац
Всем пофиг на артикли
зависит от компании
источник