Size: a a a

DocOps-сообщество

2020 November 11

А

Александр Мокрушин... in DocOps-сообщество
да я не спорю, что с большим DOCX-файлом тяжело будет работать
источник

EN

Ekaterina Noskova in DocOps-сообщество
Fox Mulder
Gdocs тормозит как незнамо что. Особенно если docx > 100 стран.
у нас таких нет
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Ekaterina Noskova
в чем неудобство? вы получаете уже согласованный док, который надо дальше прогнать по автоматизированному процессу и все. в гите у вас все сохраняется
История изменений в ходе согласования документа теряется

Разбивать docx'ину обратно на исходники - кропотливая работа, даже если переводить часть через pandoc

Два source of truth (git и docx) - возникает шанс потери информации при переносе её туда-сюда
источник

EN

Ekaterina Noskova in DocOps-сообщество
Александр Мокрушин
а в гугл док тексты выносите вручную или автоматизировали выгрузку?
вручную и в репозиторий тоже пока вручную, но работаем над автоматизацией
источник

А

Александр Мокрушин... in DocOps-сообщество
Ekaterina Noskova
вручную и в репозиторий тоже пока вручную, но работаем над автоматизацией
спасибо за ответы
источник

А

Александр Мокрушин... in DocOps-сообщество
Vadim Smelyanskiy
История изменений в ходе согласования документа теряется

Разбивать docx'ину обратно на исходники - кропотливая работа, даже если переводить часть через pandoc

Два source of truth (git и docx) - возникает шанс потери информации при переносе её туда-сюда
пока можно решить процессами внутри команды писателей: подключать нормоконтролера, например
источник

FM

Fox Mulder in DocOps-сообщество
Кстати, а как вы добились однообразности docx, Ведь команда может работать с вордом под разными ОС, а там как известно всё может поломаться или пойти не так?
Через подкладывание пандоку шаблона при конвертации?
источник

EN

Ekaterina Noskova in DocOps-сообщество
Vadim Smelyanskiy
История изменений в ходе согласования документа теряется

Разбивать docx'ину обратно на исходники - кропотливая работа, даже если переводить часть через pandoc

Два source of truth (git и docx) - возникает шанс потери информации при переносе её туда-сюда
как вы используете историю изменений? есть же тикеты, в которых описывается, что меняется
источник

А

Александр Мокрушин... in DocOps-сообщество
Fox Mulder
Кстати, а как вы добились однообразности docx, Ведь команда может работать с вордом под разными ОС, а там как известно всё может поломаться или пойти не так?
Через подкладывание пандоку шаблона при конвертации?
можно использовать одинаковый шаблон
источник

FM

Fox Mulder in DocOps-сообщество
Ekaterina Noskova
как вы используете историю изменений? есть же тикеты, в которых описывается, что меняется
Тикеты хороши для внутренней команды. Заводить вручную тикеты когда кто-то из заказчиков вносит правку в docx на gdocs - ну такое себе
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Ekaterina Noskova
как вы используете историю изменений? есть же тикеты, в которых описывается, что меняется
По тикетам вылавливать ответ на вопрос "откуда взялась эта строчка" в разы дольше, чем вызвать git blame
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Надо отметить, что ID таски в сообщении к коммиту тоже полезно, добавляет контекст про этапность работ, кто авторизовал изменения и т.д.

Т.е. таски тоже хорошо, просто одно другое не заменяет
источник

СФ

Семён Факторович... in DocOps-сообщество
вот это да!
источник

OC

Oleg Chirukhin ☄️🧙‍♂... in DocOps-сообщество
yahoooooo!
источник

NV

Nick Volynkin in DocOps-сообщество
звезда Хабра, между прочим https://habr.com/ru/users/olegchir/
источник

OC

Oleg Chirukhin ☄️🧙‍♂... in DocOps-сообщество
ох
источник

CV

Cro Vin in DocOps-сообщество
Ничего себе публикаций сколько!
источник

ИУ

Илья Улеско... in DocOps-сообщество
Mada mada ;)
источник

FM

Fox Mulder in DocOps-сообщество
источник
2020 November 12

IC

Ivan Cheban in DocOps-сообщество
И ещё одна статья из их блога на эту тему, но в ней больше рассказывается об инструментах для создания сайта, включая историю: Джекилл там тоже был.
https://github.blog/2020-10-14-how-we-open-sourced-docs-github-com/
источник