Ms
И поиск самому надо прикручивать)
Size: a a a
2020 February 24
R
Ну, в маркдауне почти ничего нет. Нет диаграмм (а это нужно), нет include, нет toc, нет инлайновых комментариев, нет labels, нет всяких "список всех страниц по такому-то фильтру с описанием каждой из них".
Ну диаграм и в конфе нет, из коробки. Они всегда берутся из какого-то внешнего источника. С остальным согласен.
Ms
Тот который в гитхабе или от алголии такое себе в плане контекста
PD
Ну диаграм и в конфе нет, из коробки. Они всегда берутся из какого-то внешнего источника. С остальным согласен.
Ну, вот возможности этих источников (т.е. бесконечное количество плагинов, в том числе и бесплатных) - и большой плюс Conflence.
PD
И поиск самому надо прикручивать)
Поиск в Confluence тоже так себе,будем честными.
Ms
Оно вообще рандомное в плане качества
R
Поиск в Confluence тоже так себе,будем честными.
Плюсую. Для простых случаев работает, но часто там совершенно невозможно найти что-то по сложному запросу
Ms
Особенно прикольно в конфлюенсе завести страницы с тем же именем внутри какого-то раздела
PD
Поэтому и нужна такая структура, что бы поиск был не нужным.
Полнотекствоый поиск - это вообще для базы знаний скорее антипаттерн (на мой взгляд).
Полнотекствоый поиск - это вообще для базы знаний скорее антипаттерн (на мой взгляд).
PD
Особенно прикольно в конфлюенсе завести страницы с тем же именем внутри какого-то раздела
Кстати, а это вообще реально?
Ms
Ну например мы завели глобальный постмортем
Ms
И есть командные постмортемы
Ms
Ключевики совпадают — конфля выдает только командные
R
Кстати, раз уж начали за всеобъемлющий Confluence. Что вы думаете про ведение спецификации API там?
Ms
Сваггер
Ms
Он умеет в демо с допилкой
Ms
В смысле запросы можно прям из доки делать
R
Сваггер
Скорее речь про OpenAPI формат, но да. Я согласен. Просто это уже разделение проектной документации по нескольким источникам
Ms
Апи нужно девам
Ms
Дока нужна всем