Телеграмм чат группы docsascode страница 866

Size: a a a

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

2021 May 06

Через sharepoint и внешние тулзы, если быть конкретным.
Версионирование тоже идёт через sharepoint.
Не git конечно, но тоже есть и не самое плохое.

источник

13:24пожаловаться #1

Vinni Winterlight in DocOps-сообщество

Документацию нужно создавать там, где это удобно.
Удобно создавать, удобно поддерживать, удобно выводить в форматы, необходимые конечному пользователю.
Word не является удобным решением для всех этих процессов.
Даже со всеми наворотами.
Тем не менее, своя ниша у него есть.

источник

13:29пожаловаться #2

Nikolaj Potashnikov in DocOps-сообщество

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

источник

13:30пожаловаться #3

Vinni Winterlight in DocOps-сообщество

Безусловно.

источник

13:31пожаловаться #4

Timofey Zakrevskiy in DocOps-сообщество

//уже скоро пятница, поэтому можно:

Что только не придумают, чтобы в ЛаТеХе не писать!

источник

13:32пожаловаться #5

Nikolaj Potashnikov in DocOps-сообщество

Именно так. И я считаю, что в процессе создания документации эта ниша — выходные артефакты для ревизии. Здесь Ворд, как и Libre Office, великолепны

источник

13:33пожаловаться #6

Fox Mulder in DocOps-сообщество

Как это делал я:
1. Закрывал docx от редактирования (но не от рецензирования)
2. Написал макрос, который вытягивал комментарии и вставляет их в в таблицу в новый docx
3. Обязал заказчика использовать свою фамилию в настройках ворда (а не все эти aa и grrr)
4. Пересылал docx и ждал же его обратно
5. Макросом выьягивал комментарии (они в ворде называются рецензии)
6. Отрабатывал их в сорсе
7. Компилил новый docx

источник

13:53пожаловаться #7

Maksim Lapshin in DocOps-сообщество

ой, ну давайте честно, о какой именно структуре идет речь?

Разрушится word art с переливающимися цветами?

Я допускаю что я за 25 лет работы с компьютерами не видел ни разу приличного использования ворда, но чаще всё обычная каша, которую итак надо разрушить.ъ

источник

13:55пожаловаться #8

Nikolaj Potashnikov in DocOps-сообщество

Эти комментарии собирались в какой-то общий журнал?

источник

13:57пожаловаться #9

Vadim Smelyanskiy in DocOps-сообщество

Обычную

Берём


 - src/intro.md
 - src/section1.md
 - src/section2.md
 - src/footer.md

Конвертируем в document.docx.
Конвертируем обратно в md - получаем слитый document.md

источник

13:58пожаловаться #10

Jonny Cuba in DocOps-сообщество

спасибо, хороший вариант.👌

источник

14:02пожаловаться #11

Fox Mulder in DocOps-сообщество

Нет. в обычный док (сам док и таблица с нужными колонками создавались макросом).
Так как я был 1, то этот док (с рецензиями) хранился у меня локально.
Думаю, что можно этот док спокойно запихнуть в тот же самый яндекс.докс

источник

14:05пожаловаться #12

Nikolaj Potashnikov in DocOps-сообщество

Да, это прямо очень хорошо

источник

14:06пожаловаться #13

Fox Mulder in DocOps-сообщество

Если будет спрос, я макрос в опен сорс кину (на гитхабе). Мне не жалко.

источник

14:08пожаловаться #14

Jonny Cuba in DocOps-сообщество

спрос есть)

источник

14:09пожаловаться #15

Nick Volynkin in DocOps-сообщество

@maxlapshin мы вот именно так делаем docx. Сначала singlehtml из сотен файлов, потом его в Ворд. Но ревьюить этот документ, к счастью, не надо.

источник

14:09пожаловаться #16

Jonny Cuba in DocOps-сообщество

4 пункт зачем делать? Показать ему новый docx с его замечаниями в табличке?

источник

14:18пожаловаться #17

Bobba Fett in DocOps-сообщество

А если сорсить не в мд, а в xml и конвертировать его в docx и обратно? Тоже не будет симметрии?

источник

14:20пожаловаться #18

Fox Mulder in DocOps-сообщество

Если док большой, то неудобно открывать, искать и т.п.
А рецензии в отдельной таблице просматривать легче. Тем более, там есть колонка - ответ на замечания. Можно таким образом вести реестр.

источник

14:20пожаловаться #19

Fox Mulder in DocOps-сообщество

Я тогда сделаю (не сегодня конечно).

источник

14:21пожаловаться #20