Size: a a a

technicalwriters

2021 March 17

VK

Vladimir Kozlov in technicalwriters
Maeg
и что это даст?
все выделения доступны для редактирования
источник

VK

Vladimir Kozlov in technicalwriters
Maeg
и что это даст?
или я что то не понял что требуется)
источник

AB

Albina Brycheva in technicalwriters
Stas Rychkov
А почему от AI решили отказаться? Если привыкли работать, вряд ли что-то заменит его.
Раз уходим от InDesign, то и необходимость AI уменьшается. Но в целом не исключаю и AI, так или иначе хранить исходники. Пока слушаю рекомендации
источник

M

Maeg in technicalwriters
Vladimir Kozlov
или я что то не понял что требуется)
ну, меня смутило, что вы назвали это "проектом"? Я просто подумала - может, там своя версионилка есть или ещё какие-нибудь атрибуты помимо тегов, которыми я не пользуюсь
источник

ET

Eduard Tibet in technicalwriters
Albina Brycheva
Эта программа умеет хранить исходники, чтобы в случае обновления скриншота, можно было обновить картинку, не рисуя заново выделения, указатели ?
Нет, это программа (а точнее инструмент) собирает исходный текст, написанный в rst в что-то подобие сайта.
источник

ET

Eduard Tibet in technicalwriters
Albina Brycheva
Хранение в виде текстовых файлов, наличие плагинов, простота, бесплатно.

Рассматривали Confluence еще, но это скорее я и программисты предлагали. До этого программисты для внутренних доков пробовали MediaWiki, но не особо успешно - один вел, другие ругались, что неудобно. Я краем глаза поглядела, тоже не зашла.
Вот собственно эти три системы.
Ну и руководителей смущает сильно БД, что в Confluence, что в XWiki.
Я бы вам порекомендовал сначала собрать требования - что нужно, а потом заниматься выбором инструментов/форматов данных.
источник

ET

Eduard Tibet in technicalwriters
Albina Brycheva
Типа того. Раньше использовала для этих целей Xara. Выше Александр подсказал про PowerPoint (я сейчас поигралась и оценила готовые объекты вроде стрелок, фигур).
Когда вела Руководства пользователей в Adobe InDesign, для редактирования картинок использовала Illustrator - в два клика из Индизайна открывается картинка в Иллюстраторе, мешяется скриншот, объекты остаются на месте и при сохранении картинвка в Руководстве обновляет автоматически
На самом деле, INDS поддерживает XML. И можно исходники хранить в xml-based markup и автоматически подгружать в InDesign на нужные места.
источник

AB

Albina Brycheva in technicalwriters
Eduard Tibet
Я бы вам порекомендовал сначала собрать требования - что нужно, а потом заниматься выбором инструментов/форматов данных.
Спасибо. Инструмент для создания базы знаний выбран. Сейчас ищу альтернативы для работы со скриншотами, чтобы в чуть меньшее количество кликов вставлять, редактировать. Ну и в принципе было удобно хранить такое количество исходникиков скриншотов и не запутаться.
источник

NV

Nick Volynkin in technicalwriters
Albina Brycheva
Спасибо. Инструмент для создания базы знаний выбран. Сейчас ищу альтернативы для работы со скриншотами, чтобы в чуть меньшее количество кликов вставлять, редактировать. Ну и в принципе было удобно хранить такое количество исходникиков скриншотов и не запутаться.
Вы же говорите, что есть шанс переубедить
источник

AB

Albina Brycheva in technicalwriters
Eduard Tibet
Нет, это программа (а точнее инструмент) собирает исходный текст, написанный в rst в что-то подобие сайта.
А, читаю по диагонали. Обсуждали прогу для работы со скринами, я на нее и думаю
источник

NV

Nick Volynkin in technicalwriters
Albina Brycheva
А, читаю по диагонали. Обсуждали прогу для работы со скринами, я на нее и думаю
Ага, я имел в виду альтернативу DokuWiki )
источник

AN

Alexey Naumenko in technicalwriters
Позволю наивный вопрос :)
источник

AN

Alexey Naumenko in technicalwriters
When dealing with multiple-argument aggregate functions, note that the ORDER BY clause goes after all the aggregate arguments. For example, write this:

SELECT string_agg(a, ',' ORDER BY a) FROM table;
источник

AN

Alexey Naumenko in technicalwriters
как найти технических писателей на английском языке (в РФ) которые умеют так писать?
источник

AN

Alexey Naumenko in technicalwriters
т.е. помимо хорошего английского ещё умеют понимать сущность того, о чем они пишут, и собирать информацию от программистов.
источник

VI

Vladimir Izmalkov in technicalwriters
Ну я писал документацию на СУБД на английском. Это не так сложно, если есть бэкграунд в IT
источник

AN

Alexey Naumenko in technicalwriters
^_^
источник

VI

Vladimir Izmalkov in technicalwriters
ищите техписов бывших разработчиков или владеющих соответствующими технологиями
источник

M

Maeg in technicalwriters
Alexey Naumenko
т.е. помимо хорошего английского ещё умеют понимать сущность того, о чем они пишут, и собирать информацию от программистов.
ммм... например, выстроить процесс так, чтобы техписам не надо было _собирать_ информацию, а она к ним поступала естественным образом (в результате задач на разработку, например). Тогда и самому разрабом не надо становиться, и других придётся теребить реже, только для уточнений или вычитки.
источник

AN

Alexey Naumenko in technicalwriters
Это само собой, и определенный процесс есть. Просто ещё есть взаимодействие с опенсорс-сообществом, например. И надо писать документацию на те штуки, которые создают *зарубежные программисты, и не всегда хорошо поясняя.
источник