Size: a a a

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

2021 September 23

NV

Nick Volynkin in DocOps-сообщество
На то они и вёдра )
источник

ME

Maria Ermakovich in DocOps-сообщество
но там даже деревянная накладка на ручку ведра )
источник

M

Maeg in DocOps-сообщество
если на документацию выделяют дизайнера - это маленькая победа :)
источник

ML

Maksim Lapshin in DocOps-сообщество
это огромная победа или ошибка.

сделать дизайн документации лучше, чем то что есть под руками у девелоперов, в разы сложнее, чем для сайта
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
Привет, Ром)) Поймал себя на мысли, что python меняется, java меняется, а текстовые языки разметки практически нет. И вообще текстовые форматы — нет. Вот вроде бы и очень старый файл, ему больше 15 лет, наверное. Изменения  с тех пор есть, даже ключевые... но действительно, не так много.

Недавно вышла спецификация ODF 1.3. Три года рождалась. И что? В строке таблицы как не было "keep with next", так и нет. Повторяющимся можно объявить только заголовок. Работа с табами как была "для ясности замнём", так и осталась. Таблицы как нельзя было внутрь списка класть, так и нельзя. Ну... электронная подпись — это да. Но, по-моему, практики подписывать офисные документы особой нет. Обычно pdf'ы и электронные форматы
источник
2021 September 24

D

Denis in DocOps-сообщество
Коллеги, очередной вопрос по docx-builder для sphinx. Как заставить его применять определенный стиль для текста в таблицах? Задавал в шаблоне, добавлял класс и назначал ему стиль в конфиге - все бесполезно, на выходе всегда стиль Normal. Таблицы csv.
источник
2021 September 27

J

Jonny Cuba in DocOps-сообщество
Включать в содержание или инклюдом в нужное место? Вот второй метод не работает
источник

J

Jonny Cuba in DocOps-сообщество
из 7 сформированных docx-файлов глоссарий работает только в одном, в остальных публикуется, но ссылки на термины не срабатывают. В web все нормально работает, но тоже ссылки ведут только на термины в том документе, в котором они работают и в docx
источник
2021 September 28

A

Alexander in DocOps-сообщество
Ребята нужна помощь!Возник конфликт при слиянии. Может кто-нибудь разбирается? Пишите в личку
источник
2021 September 29

LR

Lydia Rudakova in DocOps-сообщество
Всем добрый день! Есть ли какой-то способ напрямую выводить pdf не в оформлении Latex через Sphinx?
источник

А

Александр Мокрушин... in DocOps-сообщество
а какая у вас ОС? Windows?
источник

LR

Lydia Rudakova in DocOps-сообщество
Да
источник

А

Александр Мокрушин... in DocOps-сообщество
попробуйте через Word и библиотеку docx2pdf
https://sph-learning.readthedocs.io/ru/latest/pdf_word.html
источник

LR

Lydia Rudakova in DocOps-сообщество
Спасибо!
источник

BO

Boris Osyanin in DocOps-сообщество
@Nick_Volynkin  доставай огнемёт
источник
2021 September 30

NV

Nick Volynkin in DocOps-сообщество
Спасибо, побанил
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
Коллеги, хочу побудить Заказчика включить в контракт на разработку информационной системы (бизнес-функции) простое и конкретное требование.

"ПО должно содержать автоматизированные тесты, позволяющие проверять  актуальность документации."

Исполнение данного требования должно подразумевать разработку и согласование с Заказчиком набора тестов для указанной проверки и их реализацию.

Прошу обоснованно покритиковать))
источник

ML

Maksim Lapshin in DocOps-сообщество
это очень непростое и довольно размытое требование.

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

Вы же говорите о тестах, проверяющих документацию. А в каком формате документация, что её можно проверять?

Дисклеймер: мы то в флюссонике себе сделали тестируемую документацию
источник

J

Jonny Cuba in DocOps-сообщество
сильно)
источник

RZ

Roman Zh in DocOps-сообщество
смущает слово актуальность — могут ли тесты её проверить?
источник