Size: a a a

technicalwriters

2020 November 18

L

Lana in technicalwriters
ключевая причина выбора была необходимость переиспользовать фрагменты между документами
источник

ДЧ

Дарья Чернавина... in technicalwriters
Не знаю, занимается ли тут кто-то медицинским ПО или устройствами: https://yandex.ru/turbo/medtecnews.ru/s/news/naukatec/zvukovye_soobshcheniya_uluchshayut_zdorove_patsientov_s_serdechnoy_nedostatochnostyu.html?utm_source=yxnews&utm_medium=desktop
источник

OY

Olga Yesina in technicalwriters
Разработка мед ПО отдельная тема ещё больше зарегулированная стандартами и приказами Минздрава. Одно радует, что стандарты свеженькие, но калька с исо
источник

DM

Dina M. in technicalwriters
Коллеги, в нашем митапе по документированию API появился ещё один спикер.
https://ptsecurity.timepad.ru/event/1471931/
Камилла Гарифуллина, старший технический писатель из Selectel, расскажет о коллаборации с разработчиками при подготовке документации к API и о том, как разместить в едином справочном центре инструкции и документацию к API.

Приглашаем пройти опрос: подробные результаты мы вышлем всем ответившим. Расскажите развёрнуто, какие у вас были сложности при документировании API – лучшему автору ответа мы дадим приз.
https://docs.google.com/forms/d/e/1FAIpQLSc8Ddk8uooY5_6LQ1k1spAukL5M8KeCtcLkHnwc3J1Jrqf6hw/viewform?vc=0&c=0&w=1&flr=0
источник

MC

Milkhail Che in technicalwriters
Lana
У https://pragmatic-km.guide/ под капотом asciidoc, генерируется Jekyll -ом
Вот уж кому нужен техпис.
Раздел "Как пользоваться" не объясняет как пользоваться, а рассказывает про "проблемы".
Ни ссылки на экзешник, ни инструкции что это и зачем.
источник

MC

Milkhail Che in technicalwriters
Так, стоп, вы, Лана, как раз и указаны в футере этого сайта ))
источник

ET

Eduard Tibet in technicalwriters
Fagor
Спорить не буду, но настоящая механика это свитчи, а не кейкапы и корпус. сейчас оборудование позволяет делать их лучше, оно точнее. А значит возможностей больше для лучших свитчей. мне вообще от китайцев механика-бабочка понравилась, такого низкого профиля для механики просто нет нигде. говорят японцы на некоторых ноутах ставят нечто подобное — но цена за 78 штук 100 баксов, корпус, паять или плата не включены. У свитчей черри, говорят качество упало, да еще и высота профиля просто убивает, а стоят они все те же 50 баксов за комплект минимум.

Как вы на ноуте работаете? Там мембранные. Да и мембранная бывает хорошая. К чему я пишу, кто раздельную клавиатуру пробовал? подумываю попытаться собрать раздельную механику (по любому сильно за 100+ выйдет).
Я НЕ работаю на ноуте. И да, я про обычную раздельную клавиатуру. Классическую от Митсуми или Chicony, но предыдущих поколений - 2002-2006 годов.
источник

ET

Eduard Tibet in technicalwriters
всем добра
Позвольте поинтересоваться, xml-based документы чем в этом плане хуже ? (Если уместно так говорить). Написанные в dita-ot
Единственное тем, что в xml-based сложно реализовать сравнение (merge) на уровне гита. Есть реализации сравнения xml на уровне сущностей на базе технологий от DeltaXML, но это уже другой уровень.
источник

FM

Fox Mulder in technicalwriters
Eduard Tibet
Я НЕ работаю на ноуте. И да, я про обычную раздельную клавиатуру. Классическую от Митсуми или Chicony, но предыдущих поколений - 2002-2006 годов.
есть классные клавы на японском рынке - realforce и HHKB
источник

F

F in technicalwriters
Dina M.
Коллеги, в нашем митапе по документированию API появился ещё один спикер.
https://ptsecurity.timepad.ru/event/1471931/
Камилла Гарифуллина, старший технический писатель из Selectel, расскажет о коллаборации с разработчиками при подготовке документации к API и о том, как разместить в едином справочном центре инструкции и документацию к API.

Приглашаем пройти опрос: подробные результаты мы вышлем всем ответившим. Расскажите развёрнуто, какие у вас были сложности при документировании API – лучшему автору ответа мы дадим приз.
https://docs.google.com/forms/d/e/1FAIpQLSc8Ddk8uooY5_6LQ1k1spAukL5M8KeCtcLkHnwc3J1Jrqf6hw/viewform?vc=0&c=0&w=1&flr=0
Часик назад у Вас ещё была регистрация доступна, сейчас уже нет. Набралось слишком много желающих послушать, или баг? Хотел бы присоединиться.
источник

FM

Fox Mulder in technicalwriters
Dina M.
Коллеги, в нашем митапе по документированию API появился ещё один спикер.
https://ptsecurity.timepad.ru/event/1471931/
Камилла Гарифуллина, старший технический писатель из Selectel, расскажет о коллаборации с разработчиками при подготовке документации к API и о том, как разместить в едином справочном центре инструкции и документацию к API.

Приглашаем пройти опрос: подробные результаты мы вышлем всем ответившим. Расскажите развёрнуто, какие у вас были сложности при документировании API – лучшему автору ответа мы дадим приз.
https://docs.google.com/forms/d/e/1FAIpQLSc8Ddk8uooY5_6LQ1k1spAukL5M8KeCtcLkHnwc3J1Jrqf6hw/viewform?vc=0&c=0&w=1&flr=0
А вот совершенно не помню, регистрировался ли я али нет
источник

L

Lana in technicalwriters
Milkhail Che
Вот уж кому нужен техпис.
Раздел "Как пользоваться" не объясняет как пользоваться, а рассказывает про "проблемы".
Ни ссылки на экзешник, ни инструкции что это и зачем.
Это волонтёрский проект туда пишут все желающие и имеющие, что сказать по теме гайда на опен сорс основе, я там не техпис, а один из авторов, кто контрибутил
источник

L

Lana in technicalwriters
То есть если тебе не нравится раздел, ты берёшь и переписываешь))
источник

L

Lana in technicalwriters
Milkhail Che
Вот уж кому нужен техпис.
Раздел "Как пользоваться" не объясняет как пользоваться, а рассказывает про "проблемы".
Ни ссылки на экзешник, ни инструкции что это и зачем.
Я может долблюсь, но что такое exe шник в этом контексте? Это же база знаний по теме управления знаниями, что там запускать?
источник

MC

Milkhail Che in technicalwriters
Lana
Я может долблюсь, но что такое exe шник в этом контексте? Это же база знаний по теме управления знаниями, что там запускать?
не, это я долблюсь, подумал, это ссылка на инструментарий по сборке
источник

L

Lana in technicalwriters
Milkhail Che
не, это я долблюсь, подумал, это ссылка на инструментарий по сборке
короче - не нравится раздел, знаешь, как улучшить, жмешь кнопку Редактировать, просишь доступ к гитлаб, кидаешь пуллреквест)
источник

L

Lana in technicalwriters
Milkhail Che
не, это я долблюсь, подумал, это ссылка на инструментарий по сборке
там вроде на главной написано что это, но если есть версии, как лучше объяснить, что это (и что сборка тут ни при чём) - велкам, проект чисто на энтузиазме сообщества делается
источник

DM

Dina M. in technicalwriters
F
Часик назад у Вас ещё была регистрация доступна, сейчас уже нет. Набралось слишком много желающих послушать, или баг? Хотел бы присоединиться.
Увеличили лимит участников – пробуйте.
источник

вд

всем добра in technicalwriters
Eduard Tibet
Единственное тем, что в xml-based сложно реализовать сравнение (merge) на уровне гита. Есть реализации сравнения xml на уровне сущностей на базе технологий от DeltaXML, но это уже другой уровень.
Премного благодарен
источник

E

Evgenya in technicalwriters
Коллеги, добрый вечер. Поделитесь, пожалуйста, опытом использования MadCap Flare, плюсы/минусы, альтернативы?
источник