Size: a a a

technicalwriters

2020 October 30

Ю

Юлия in technicalwriters
Прочитала требования. И просто вздохнула... Искала подобное летом))) эх...

Удачи вам в поисках.
источник

KC

Kseniya Chudakova in technicalwriters
Семён Факторович
в условиях удаленки все мы немного самый главный человек, сами убираем свое рабочее место
Ждём лекцию "Как управлять распределённой командой техписов"
источник

rK

rJIynbIu` KOT in technicalwriters
Kseniya Chudakova
Ждём лекцию "Как управлять распределённой командой техписов"
у них по этому поводу курс есть, так что лекции вряд ли дождётесь
источник

KC

Kseniya Chudakova in technicalwriters
rJIynbIu` KOT
у них по этому поводу курс есть, так что лекции вряд ли дождётесь
да, я очень жду этот курс)
источник

OR

Olga Rodina in technicalwriters
Kseniya Chudakova
Ждём лекцию "Как управлять распределённой командой техписов"
источник

MC

Milkhail Che in technicalwriters
Семён Факторович
а уточните задачу? вы хотите генерить DOCX, но при этом не писать в ворде?

или выходной формат другой?
@factorized
Нужен PDF и WebHelp локальный. + хочется читаемые исходники, чтоб мёрджить грамотно, и видеть историю версий в гите.
Так же, работая с H&M привык к переменным, условаиям, настраиваемым стилям и т.д.
источник

MC

Milkhail Che in technicalwriters
Stas Rychkov
Автосборку?
Батник, запускающий таски H&M запустить по времени не проблема.
источник

ДС

Дмитрий Сунцов... in technicalwriters
Milkhail Che
@factorized
Нужен PDF и WebHelp локальный. + хочется читаемые исходники, чтоб мёрджить грамотно, и видеть историю версий в гите.
Так же, работая с H&M привык к переменным, условаиям, настраиваемым стилям и т.д.
что не так с DITA?
"я настолько привык, что уже не замечаю код" (с)
источник

MC

Milkhail Che in technicalwriters
Дмитрий Сунцов
что не так с DITA?
"я настолько привык, что уже не замечаю код" (с)
Не использовал. Вроде, функционал весь нужный есть, рекомендуете?
источник

ДС

Дмитрий Сунцов... in technicalwriters
ну мы пользуем, да
источник

ET

Eduard Tibet in technicalwriters
Kseniya Chudakova
Ждём лекцию "Как управлять распределённой командой техписов"
На самом деле уже давным давно по этому поводу написана книга: https://xmlpress.net/publications/managing-writers/ А также есть подкаст с ним у Тома Джонсона.
источник

ET

Eduard Tibet in technicalwriters
Milkhail Che
Не использовал. Вроде, функционал весь нужный есть, рекомендуете?
Все зависит от объемов. Если объемы маленькие, то DITA - это не то, что вам нужно.
источник

ET

Eduard Tibet in technicalwriters
На самом деле на xmlpress много занятной литературы. Не для всех, конечно, но многие найдут что-то для себя.
источник

AY

Andrei Yemelianov in technicalwriters
Milkhail Che
@factorized
Нужен PDF и WebHelp локальный. + хочется читаемые исходники, чтоб мёрджить грамотно, и видеть историю версий в гите.
Так же, работая с H&M привык к переменным, условаиям, настраиваемым стилям и т.д.
поделюсь своим опытом:
1. Для небольших документов H&M неплох.
2. Для больших документов со сложной структурой  не очень подходит уже потому, что они слишком долго собираются.
3. Ограниченные возможности по работе с HTML-документами (странная табличная вёрстка, невозможность полноценного добавления собственных стилей).
4. Практически полная невозможность интеграции с другими инструментами
5. Организовать автосборку на сервере тоже сложно (см. пункт 2).
источник

ДС

Дмитрий Сунцов... in technicalwriters
DITA+Oxygen Author+GIT:
автосборка PDF, WebHelp и еще десятка форматов в один клик
девопсы организовали автоапдейт сайта после пуша в гит в нужную ветку
фронтендеры намутили скин для WebHelp
...
профит!
источник

ДС

Дмитрий Сунцов... in technicalwriters
при желании PDF через CSS тоже становится нарядным
источник

ДС

Дмитрий Сунцов... in technicalwriters
из сложностей - немножко тегов запомнить в редакторе и организовать процессы в компании
источник

ДС

Дмитрий Сунцов... in technicalwriters
последнее - самое сложное
источник

НО

Наталья Орлова... in technicalwriters
Дмитрий Сунцов
DITA+Oxygen Author+GIT:
автосборка PDF, WebHelp и еще десятка форматов в один клик
девопсы организовали автоапдейт сайта после пуша в гит в нужную ветку
фронтендеры намутили скин для WebHelp
...
профит!
Одна только настройка этого стека - еще то приключение с привлечением девопсов и разрабов. Плюс отдельно обучение всех  заинтересованных лиц тому, как в этом все работать, чтоб не поломать.
источник

ДС

Дмитрий Сунцов... in technicalwriters
гит в конторе обычно уже есть
купить софтину и разобраться в ней остается.
я пришел без опыта техписа вообще. за пару недель разобрался
источник