Size: a a a

technicalwriters

2020 November 18

IC

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

E

Evgenya in technicalwriters
Благодарю, изучу
источник

IC

Ivan Cheban in technicalwriters
Я использую MadCap Flare в последнее время дня изготовления красивых пдф. Для онлайн документации переключился на генераторы статических сайтов.
источник

IC

Ivan Cheban in technicalwriters
Из минусов, которые я чаще всего слышу о мэдкепе, что он дорогой и только под Виндоус
источник

E

Evgenya in technicalwriters
Спасибо. Можно использовать MadCap для веб-версии справки?
источник

IC

Ivan Cheban in technicalwriters
Да, это же single source. Из одного источника можно собирать пдф и онлайн справку
источник
2020 November 19

ET

Elena Tikhomirova in technicalwriters
Привет! А какоц опыт работы с XMetaL? Использует DITA Extensions и DITA OT. Исходники в xml, есть визуальный редактор с подсвеченными тегами. Single source. На выходе у нас pdf и html. Много переиспользования кусков текста/топиков между документами. Переменные и всякие legal страницы, задаются централизованно. Также позволяет централизованно задавать требования к форматированию разных видов топиков, к наименованию. (Актуально для больших распределенных команд.)

Иногда я грущу, когда у меня задание поменять пару слов, а нужно развернуть вот это все, не мгновенно найти тему и место, потом генерить и выкладывать нов. документ. В Ворде ой как проще)) но html из него не генерится.

Радует чужой положительный опыт с аскидок. Год назад я написала на нем документ с несколькими инклудами. проверяла  по превью в хроме (есть плагин - здесь подскащали, возможно, Андрей Е.). До генерации билдов дело не дошло. До публикации тоже. Писала в notepad++ Теперь чувствую себя ослом - видя, что другие пользуются ide. в общем, аскидок хорош. не помню вообще никаких ограничений, чего не удалось бы реализовать в плане структуры. (учить их хелп надо, да.)

Чем мне не нравится html- продукция HAT’ов (XMetaL туда же, H&M) - это топорный вид этих страниц. Мы все читаем веб-страницы, состоящие из множества интерактивных блоков. А тут такая монолитная портянка (другого html output у себя по рабботе в двух местах не видела). Да, можно css улучшить. Но хочется именно полноценного сайта, портала. Поэтому теоретически я - за всякие Jekyll.
источник

ET

Elena Tikhomirova in technicalwriters
Еще вопрос, как вы относитесь к URL веб-справки. Для меня это часть веб-интерфейса. Хотелось бы короткие урлы, аккуратно названные файлы, без нижних подчеркиваний, без CamelCase и т.п. Но у нас есть жесткие требования к наименованию файлов, папок (все это уходит в структуру урла, например, так может быть: www.xyz.com/ProductName/En_US/help/help/Internal_Folder_Name_EN/xxxx_management/t_create_new_subscription.html)
Мой внутренний перфекционист воет при виде такого, но что-либо менять запретили.
источник

ET

Elena Tikhomirova in technicalwriters
Но! Есь еще одна надежда))) Должны быть какие-то движки, которые преобразуют структуру вложенных папок с файлами в более «юзабильную» структуру итогового сайта. Не слышали о таком?

По моим предположениям, логика должна быть, как в эндпоцнтах АПИ: они не копируют структуру данных в БД, это некоторая абстракция, призванная сделать пользование этими URL’ами интуитивно понятными и предсказуемым. (кст, в неоулдскульных веб-сервисах урл млжно использовать для навигации по вкладкам, модификации поисковых запросов.) на фоне всего этого веб-справка из HAT (но, возможно, и из аскидок+генератор сайтов - примеров не видела) выглядит отсталой и неполнофункциональной. бывает по-другому?

т.е. как делают «кульные» урлы, где нет ничего лишнего, «подкапотного»?
например, www.xyz.com/FAQ/how-to-kill-yourself-remporarily.html
источник

MC

Milkhail Che in technicalwriters
Evgenya
Коллеги, добрый вечер. Поделитесь, пожалуйста, опытом использования MadCap Flare, плюсы/минусы, альтернативы?
Вместо MadCap за 100 уе в месяц я бы купил HelpandManual за 500 пожизненно)
источник
2020 November 20

ET

Eduard Tibet in technicalwriters
Кто тут интересовался клавиатурами или присматривал себе что-то. Хорошие обзоры классических механик от классного чувака: https://www.youtube.com/user/Chyrosran22/videos М.б. и для себя что-то найдете :)
источник

SL

Stan Lo in technicalwriters
Всем привет! А ранее тут обсуждали вопрос феминитивов для "технического писателя"? Поиск вроде не дал результатов. Возможно, плохо искал.
Вот как будет: техническая писательница, документаторша, инженерка по разработке документации? 😉
источник

АЖ

Ася Жарова in technicalwriters
Stan Lo
Всем привет! А ранее тут обсуждали вопрос феминитивов для "технического писателя"? Поиск вроде не дал результатов. Возможно, плохо искал.
Вот как будет: техническая писательница, документаторша, инженерка по разработке документации? 😉
Пока это не зафиксировано в словарях, спросите конкретную даму, как она хочет, чтобы её называли.
источник

H

Hartmann in technicalwriters
Stan Lo
Всем привет! А ранее тут обсуждали вопрос феминитивов для "технического писателя"? Поиск вроде не дал результатов. Возможно, плохо искал.
Вот как будет: техническая писательница, документаторша, инженерка по разработке документации? 😉
С козырей решили зайти, вбросить? ;)
источник

НО

Наталья Орлова... in technicalwriters
Hartmann
С козырей решили зайти, вбросить? ;)
Пятница...
источник

H

Hartmann in technicalwriters
Кстати, действительно призадумался как будет на украинском звучать должность тех писательницы, если уж на то пошло... Один из вариантов тэхнiчна докумэнткыня. На русском — писателька, как вариант.
По-моему, очень прогрессивно, в ногу со временем.
источник

CV

Cro Vin in technicalwriters
Пятничная тема.
Интерес для звучания представляют, на мой не претендующий на общность взгляд, слова иностранного происхождения (н-р, масон) :)
источник

АП

Александр Парень... in technicalwriters
Прикольно я когда начал изучать испанский, сразу спросил как будет технический писатель, ответили так, насколько правильно не могу сказать: técnico de escritor
источник

O[

Olga [olgademoscu] in technicalwriters
Александр Парень
Прикольно я когда начал изучать испанский, сразу спросил как будет технический писатель, ответили так, насколько правильно не могу сказать: técnico de escritor
Escritor/a tecnico/a
источник

MS

Maria Shabanova in technicalwriters
Ася Жарова
Пока это не зафиксировано в словарях, спросите конкретную даму, как она хочет, чтобы её называли.
Дама хочет, чтобы её называли госпожой 🤣
источник