ДС
сейчас только мелкие всякие плюшки иногда изучаю по необходимости. в остальном хватает. уже тимлид и пишу статьи для новых техписов, чтоб быстрее вникали
Size: a a a
2020 October 30
ДС
дефолтные шаблоны вебхелпа кстати тоже вполне себе юзабельны
ДС
немножко обучения да, надо. а где без этого живут?
AY
Одна только настройка этого стека - еще то приключение с привлечением девопсов и разрабов. Плюс отдельно обучение всех заинтересованных лиц тому, как в этом все работать, чтоб не поломать.
Наталья, а вы знаете, какие бывают поломки на H&M?
ДС
у нас еще плюсом Confluence для внутрянки по отделам и JIRA
может я еще чего не знаю..
может я еще чего не знаю..
AY
Дмитрий высказывает вполне нормальную идею
AY
да, работать сложно - но это рабочий вариант
AY
и если будете переходить с H&M на какой-нибудь другой инструмент (или надо будет срочно перевести тексты в другой формат) - потратите кучу времени
AY
тексты из диты легко конвертируются при помощи стандартной утилиты pandoc
НО
Наталья, а вы знаете, какие бывают поломки на H&M?
Я с H&M дела не имела. А вот связку DITA+Oxygen Author+GIT, далее Bamboo и прочие радости жизни год использовала. Если честно - мне очень не нравилось.
AY
не дай Бог придётся работать в H&M с текстами на китайском, японском, арабском языках... cобирается очень долго
AY
Я с H&M дела не имела. А вот связку DITA+Oxygen Author+GIT, далее Bamboo и прочие радости жизни год использовала. Если честно - мне очень не нравилось.
вот поэтому я и являюсь сторонником более простой связки:
markdown в любом редакторе + pandoc+GIT
markdown в любом редакторе + pandoc+GIT
ДС
изкаробки во что можно конвертить
FM
гит в конторе обычно уже есть
купить софтину и разобраться в ней остается.
я пришел без опыта техписа вообще. за пару недель разобрался
купить софтину и разобраться в ней остается.
я пришел без опыта техписа вообще. за пару недель разобрался
То есть, вы разобрались в:
- dita
- xslt
- xsl
- css
- ant
- dtd
- apache-fop
===
И всё это за 2 недели?
Снимаю шляпу. Мне до вас как муравью до Китая. Мне потребовалось полгода, что бы выдать хоть какие-то первые путные результаты.
- dita
- xslt
- xsl
- css
- ant
- dtd
- apache-fop
===
И всё это за 2 недели?
Снимаю шляпу. Мне до вас как муравью до Китая. Мне потребовалось полгода, что бы выдать хоть какие-то первые путные результаты.
AY
в современных условиях повсеместной удалёнки H&M тоже неудобен - либо ставим на домашние компы сотрудников (а это дополнительные лицензии), либо подключаемся к виндовой машине по RDP
AY
гораздо проще писать в любом редакторе в markdown/asciidoc, потом коммитить - и всё
AY
конечно, можно и XML руками править - но самоубийц среди нас, надеюсь, нет
ДС
я разобрался в DITA и GIT
этого хватило чтобы начать работать и выполнять задачи.
дальше уже сам копал в настройки трансформации, выяснил, как работает WebHelp.
попытался что-то покрутить сам, потом нашел годный дизайн сайта, в исходниках которого увидел упоминание того же вебхелпа
поставил задачу фронтенду - они подкрутили CSS одного из шаблонов - получился нарядный вариант, который всем понравился
дальше занялся процессами, чтоб техписов не игнорили и вовремя сообщали об изменениях.
попутно написал пару скриптов для деплоя и договорился с девопсами, чтоб под нас подняли сайт и прикрутили к гиту
этого хватило чтобы начать работать и выполнять задачи.
дальше уже сам копал в настройки трансформации, выяснил, как работает WebHelp.
попытался что-то покрутить сам, потом нашел годный дизайн сайта, в исходниках которого увидел упоминание того же вебхелпа
поставил задачу фронтенду - они подкрутили CSS одного из шаблонов - получился нарядный вариант, который всем понравился
дальше занялся процессами, чтоб техписов не игнорили и вовремя сообщали об изменениях.
попутно написал пару скриптов для деплоя и договорился с девопсами, чтоб под нас подняли сайт и прикрутили к гиту
ДС
учитывая размер компании - все это не так быстро, как хотелось бы, но однозначно виден прогресс.