Size: a a a

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

2021 April 30

L

Lana in DocOps-сообщество
да, достала из подземелья)
источник

L

Lana in DocOps-сообщество
ну в обоих случаях, для меня между двумя утверждениями логический пробел, как из А стало Б
источник
2021 May 05

J

Jonny Cuba in DocOps-сообщество
Коллеги, интересует вопрос ревью документов, которые созданы с помощью "единого источника". Вот мы создали документ docx для госзаказчика, все хорошо, красиво, присылает он правки и вот здесь лично у меня тупик, заказчик наотрез отказывается использовать что-то кроме word и я их понимаю, но как  делать ревью?. Правите в word и одновременно правите markdown-файлы? Получается двойная работа и сомнительное удобство. Генерировать  первый драфт, а потом уже тупо работать в  word? Все прелести верски пропадут. Кто как решает этот вопрос?
источник

NV

Nick Volynkin in DocOps-сообщество
Можно принять ворд с комментариями, исправить исходник в markdown, пересобрать из него word, отдать на второй раунд рецензирования. Сам ворд никогда не правим. Точно так же, никогда не правим сырой HTML на сайте и любой другой выходной формат.
источник

J

Jonny Cuba in DocOps-сообщество
тут другое слабое место, если с какими то комментариями не согласен или они подвисают, то в новой сборке их уже не будет
источник

NV

Nick Volynkin in DocOps-сообщество
Да, есть такая проблема. Насколько я помню, в @foliantdocs эту проблему решили для публикации в Confluence.
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
я думаю, неразресолвленные комментарии можно переносить в MD
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
в смысле, в виде комментариев
источник

J

Jonny Cuba in DocOps-сообщество
да, но не завелся у меня foliant, пока решили на sphinx+pandoc остановиться.
источник

J

Jonny Cuba in DocOps-сообщество
это как?
источник

ML

Maksim Lapshin in DocOps-сообщество
раз заказчик наотрез отказывается жить вне ворда, значит с вероятностью около 100% часть исправлений будет втихаря без комментариев.

Т.е. вам всё равно нужен механизм сравнить, построить дельту от того, что ему выслали и вернули обратно.

Плюс гарантированно у вас будет не туда-сюда-туда-сюда, а ветвление. Люди, живущие в ворде, неизбежно сваливаются в бардак ветвления версий этого ворда.

Ну и да, вам нужен человек, разгребать этот бардак.  Если на работе с госзаказчиком нет маржи столько, чтобы окупить этого человека, то большой вопрос, зачем это нужно
источник

J

Jonny Cuba in DocOps-сообщество
этот человек я), вот сейчас как раз задумался над этим как все смержить, выводим продукт в opensource соответственно будет доки и для госзаказчика и хорошая документация для сайта
источник

ML

Maksim Lapshin in DocOps-сообщество
мда, неприятно быть «тем самым человеком» =)

Я бы начал с того, что научился бы получать изменения ворда в diff формате. Это мержить в маркдаун, как источник правды
источник

ML

Maksim Lapshin in DocOps-сообщество
а в ворде правды нет
источник

J

Jonny Cuba in DocOps-сообщество
ага)) вот я и хочу максимально от word отказаться и получается, остался только госзаказчик) спасибо за подсказку.
источник

ML

Maksim Lapshin in DocOps-сообщество
в зависимости от того, насколько всё будет плохо, можно даже попробовать автоматизировать извлечение диффов из писем.

Почти гарантированно часть правок делается без режима комментирования и иногда это даже происходит по ошибке, случайно, без злого умысла.

Но чужие юристы — они вот это делают как правило из желания схитрить
источник

АВ

Александр Внучков... in DocOps-сообщество
В недавно обсуждавшихся в соседнем чате (technicalwriters) Яндекс-документах (которые Р7-Офис, который ONLYOFFICE) есть режим сравнения документов (вкладка "Совместная работа" - "Сравнить") - можно посмотреть по-быстрому, одинаковые документы, или что-то поменялось
источник

J

Jonny Cuba in DocOps-сообщество
Спасибо, посмотрю
источник

J

Jonny Cuba in DocOps-сообщество
даже про это не думал, не сталкивался с таким
источник

A🐛

Alex 🐛 F in DocOps-сообщество
MS Word это тоже умеет
источник