Size: a a a

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

2021 October 13

SP

Stanislav Popov in DocOps-сообщество
источник

D

Denis in DocOps-сообщество
Подскажите, нет ли какого расширения или другого способа в VSCode, чтобы отображать дерево навигации по заголовкам (типа как в ворде)? Язык разметки rst.
источник

NV

Nick Volynkin in DocOps-сообщество
В исходнике навигация?
источник

D

Denis in DocOps-сообщество
Ну типа. Для маркдауна вроде есть.
источник

AB

Anton Bezkrovny in DocOps-сообщество
Всем привет!
Подскажите, есть ли у sphinx функция автосборки таблиц, как в confluence?
источник
2021 October 14

NV

Nick Volynkin in DocOps-сообщество
А как в Confluence?
источник

AA

Anastasiia Antonenko in DocOps-сообщество
пост топ🔥
и мне очень вовремя, я как раз хотела начать расставлять в конфлюенсе  теги: how-to, tutorial, explanation, refeference
источник

AB

Anton Bezkrovny in DocOps-сообщество
как макрос Редактировать макрос ‘Отчет по свойствам страницы’

есть множество страниц, где добавлен макрос «Свойства страницы» и внутри него обычная таблица

а макрос «Отчет по свойствам» делает из множеста макросов «Свойства страницы» делает сводную таблицу
источник

AB

Anton Bezkrovny in DocOps-сообщество
грубо говоря вот свойства
источник

AB

Anton Bezkrovny in DocOps-сообщество
вот сводная
источник

AB

Anton Bezkrovny in DocOps-сообщество
искал нечто подобное для sphinx, пока остановился на https://sphinxcontrib-needs.readthedocs.io/en/latest/ но это не то 🙁
источник

A

ARN in DocOps-сообщество
не могу установить Markdown_Editor_v1.12.253.vsix для Visual Studio Code 1.61.1 (user setup) ... посоветуйте что делать, пожалуйста
источник

A

ARN in DocOps-сообщество
очень хочется посмотреть на самом ли деле продвинутый парсер markdig может строить грид таблицы с объединенными ячейками для markdown pandoc
источник

A

ARN in DocOps-сообщество
источник

A

ARN in DocOps-сообщество
источник
2021 October 15

сп

старый пердун... in DocOps-сообщество
Тема метатегов не раскрыта. Чем они плохи и почему меня, читателя, лишают найти что-то по воспоминаниям вида «не помню, где, не помню, как зовётся, но вроде инструкция была»? (Или такой поиск один я практикую, пусть и нечасто?)

Я могу понять, если эти слова и так встречаются в названиях страниц, но это ведь не всегда так, а дописывать в запросах «-faq -регламент -"карточка продукта"» быстро надоедает.
источник

Y

Yaroslav in DocOps-сообщество
а раздела инструкций нет при этом?
источник

NV

Nick Volynkin in DocOps-сообщество
Ну это как на все статьи документации повесить метку документация. Это ж и так понятно, не добавляет информативности.

Метка должна помогать дихотомировать всю массу статей в базе знаний. Если метка применима к 90% статей, она не помогает в поиске.
источник

iv

iakov v in DocOps-сообщество
вообще люди, работающие в библиотеках, уже наработали в этом деле много опыта. книжный фонд делится в каталоге по нескольким фасетам, но основной интерес для читателя, пользующегося каталогом, обычно представляет предметный каталог (subject catalog), соответственно, книги сгруппированы именно по "ключевым словам", относящимся к их содержанию. а вот вид документа - это другой фасет, который в некоторых случаях тоже бывает важен, но в рамках поиска в Confluence, например, действительно мало полезен (если только вы не хотите, например, вывести на одну страницу список всех ваших how-to, которые предварительно пометите тегом "how-to")
источник

SR

Stas Rychkov in DocOps-сообщество
Метка в Confluence как раз неплохо дополняет полнотекстовый поиск. То есть в нём, парадокс, может как раз сработать добавление метки на 100% страниц. Из-за кривого полнотекстового поиска.
источник