Size: a a a

2019 November 19

KP

Kate Potapova in technicalwriters
Спасибо большое!
источник

KP

Kate Potapova in technicalwriters
Roht
Camtasia (платно)
Лучше бесплатную
источник
2019 November 20

АП

Александр Парень in technicalwriters
Kate Potapova
Лучше бесплатную
Obs64
источник

СФ

Семён Факторович in technicalwriters
отличный продукт, но со всей возможной спецификой опенсорса:( умеет всё, запускается везде, но иногда необъяснимо и неисправимо глючит
источник

СФ

Семён Факторович in technicalwriters
потратил около 5 часов, чтобы запинать на маковской версии живую трансляцию в YouTube, но так и не сумел
источник

FM

Fox Mulder in technicalwriters
А говорят на маке всё работает даже под домохозяйкой
источник

СФ

Семён Факторович in technicalwriters
не всё и не всегда:)
источник

АП

Александр Парень in technicalwriters
Семён Факторович
отличный продукт, но со всей возможной спецификой опенсорса:( умеет всё, запускается везде, но иногда необъяснимо и неисправимо глючит
Таков уж опенсоурз
источник

V

Vanderhoof in technicalwriters
В Mojave появилась встроенная записывалка под cmd+shift+5. Я не домохозяйка, но митап записался легко и просто. Правда, потом пришлось пережимать, потому что файл получился очень большой.

Не уверен, правда, что это всё можно подружить со стримами ютуба
источник

KP

Kate Potapova in technicalwriters
Спасибо большое!
источник

СФ

Семён Факторович in technicalwriters
У меня есть задача объяснить концепцию RESTful API человеку с практически нулевым бэкграундом в Computer Science.

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

Хочется донести мысль, что документация на API — абсолютно обязательный предмет: без нее разработчик, каким бы умным он ни был, физически не сможет пользоваться API.

Какую аналогию из реального мира можно было бы взять для такого объяснения?
источник

НО

Наталья Орлова in technicalwriters
Банки с приправами, непрозрачные. Не написано, что на банке - результат непредсказуем. Или лекарства.
источник

V

Vanderhoof in technicalwriters
>> Какую аналогию из реального мира можно было бы взять для такого объяснения?

Получение любой государственной услуги) Вроде знаешь, куда идти, и кабинеты все перед глазами, но в каком порядке надо в них заходить, и что с собой принести — без подробной документации сам чёрт не разберётся : )
источник

MS

Maxim Shabanov in technicalwriters
Семён Факторович
У меня есть задача объяснить концепцию RESTful API человеку с практически нулевым бэкграундом в Computer Science.

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

Хочется донести мысль, что документация на API — абсолютно обязательный предмет: без нее разработчик, каким бы умным он ни был, физически не сможет пользоваться API.

Какую аналогию из реального мира можно было бы взять для такого объяснения?
ПДД и езда по дорогам подойдет?)
Без знания ПДД по дорогам безопасно не поездишь. Хотя и притянутый примерчик, первое, что пришло на ум.
источник

СФ

Семён Факторович in technicalwriters
Vanderhoof
>> Какую аналогию из реального мира можно было бы взять для такого объяснения?

Получение любой государственной услуги) Вроде знаешь, куда идти, и кабинеты все перед глазами, но в каком порядке надо в них заходить, и что с собой принести — без подробной документации сам чёрт не разберётся : )
вот это кстати хорошо!

развивая идею, еще подойдет аналогия с профосмотром: ты знаешь, какой тебе нужен результат, но без бумажки со списком врачей и номеров кабинетов ты точно не справишься
источник

L

Lana in technicalwriters
Семён Факторович
У меня есть задача объяснить концепцию RESTful API человеку с практически нулевым бэкграундом в Computer Science.

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

Хочется донести мысль, что документация на API — абсолютно обязательный предмет: без нее разработчик, каким бы умным он ни был, физически не сможет пользоваться API.

Какую аналогию из реального мира можно было бы взять для такого объяснения?
отправка письма на почте, письмо нужно подписать, указать адрес (эндпойнт) и все элементы адреса, город, улица, квартира, индекс (обязательные параметры), способ отправки (аналогия с методом), наклеить марку с нужной ценой и в нужный угол конверта, иногда - описать содержимое (тело запроса), еще иногда письма бывают с уведомлением о вручении (ответ сервера), все эти правила - такой же контракт, не написал индекс или не знаешь его - письмо будет идти дольше или не дойдет вовсе, также, если у адресата поменялся адрес или цена марки до пункта назначения - а ты не знаешь об этом, писбмо не дойдет
источник

YD

Yuri Dobrev in technicalwriters
по моему опыту, всегда прекрасно заходит не аналогия, а реальный пример - сайт-агрегатор авиабилетов должен как-то собрать инфу с компаний о ценах и доступности и провернуть заказ
источник

СХ

Саша Хо in technicalwriters
Семён Факторович
У меня есть задача объяснить концепцию RESTful API человеку с практически нулевым бэкграундом в Computer Science.

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

Хочется донести мысль, что документация на API — абсолютно обязательный предмет: без нее разработчик, каким бы умным он ни был, физически не сможет пользоваться API.

Какую аналогию из реального мира можно было бы взять для такого объяснения?
Это конкретный человек? Если да, тогда, мне кажется, надо смотреть, в чём он разбирается, и искать примеры там. А то аналогия может не сработать.
источник

SR

Stas Rychkov in technicalwriters
Семён Факторович
У меня есть задача объяснить концепцию RESTful API человеку с практически нулевым бэкграундом в Computer Science.

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

Хочется донести мысль, что документация на API — абсолютно обязательный предмет: без нее разработчик, каким бы умным он ни был, физически не сможет пользоваться API.

Какую аналогию из реального мира можно было бы взять для такого объяснения?
Аналогия простая. Если разработчик не будет знать, писать ему True или False, готовый проект сломается в самый неподходящий момент. Потому как бит -- вероятностная характеристика. А понять кто виноват будет невозможно. Не было документации.
источник

NV

Nick Volynkin in technicalwriters
Stas Rychkov
Аналогия простая. Если разработчик не будет знать, писать ему True или False, готовый проект сломается в самый неподходящий момент. Потому как бит -- вероятностная характеристика. А понять кто виноват будет невозможно. Не было документации.
Человек с нулевым бэкграундом в Computer Science может и не знать про True/False.
источник