На то они и вёдра )

но там даже деревянная накладка на ручку ведра )

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

это огромная победа или ошибка.

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

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

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

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

Включать в содержание или инклюдом в нужное место? Вот второй метод не работает

из 7 сформированных docx-файлов глоссарий работает только в одном, в остальных публикуется, но ссылки на термины не срабатывают. В web все нормально работает, но тоже ссылки ведут только на термины в том документе, в котором они работают и в docx

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

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

а какая у вас ОС? Windows?

Да

попробуйте через Word и библиотеку docx2pdf
https://sph-learning.readthedocs.io/ru/latest/pdf_word.html

Спасибо!

@Nick_Volynkin  доставай огнемёт

Спасибо, побанил

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

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

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

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

это очень непростое и довольно размытое требование.

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

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

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

сильно)

смущает слово актуальность — могут ли тесты её проверить?