ну к примеру есть тысяча HTML файлов с топиками.

я говорю - вот группа Клиент1
внутри группы есть юзер1 и юзер2

я настраиваю, что юзер1 видит 100 топиков таких то
юзер2 видит всю тысячу
юзер3 видит ещё другие 300

есть группа Клиент2
внутри свои юзеры со своими правами


но при всем при этом файлы HTML для всех одинаковые!


и в зависимости от того, какой юзер зашёл на портал - он видит свой набор топиков

меняем "юзер" на "роль" или добавляем ещё новую сущность роли  в ту же схему. и получаем то что нужно

постоянно сгораю от стыда, читая свои старые тексты )

А так? https://www.netlify.com/blog/2019/01/31/restrict-access-to-your-sites-with-role-based-redirects/

Или так? https://github.com/topics/role-based-access-control

Смотрели что-то такое?

Я бы дал совет - уходить от dita в сторону легковесных языков.
На текущем проекте я сделал сайт на основе asiidoc + antora. Сайт предусматривает, на данный момент) такие разграничения, как:
- вывод контента по релизам
- вывод контента по типам документации
- вывод контента под разных заказчиков
- поиск по контенту
- планируется автоматический конверт pdf(docx)

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

В итоге, команда пишет в аскидоке и сливают в свои репы,  делаем ревью и делаее мердж-реквест в мастер и по релизным веткам. Я билдю ./public через антору, при этом, настроенный пайплайн стягивает контент сам и сам же, через подложенный мною структура сайта (всякие js+css) билдит сайт.
Далее сайт помещается на апач (пока ручками). Ну и авторизация не прикручена, ибо пока в прод не пущен проект

В oxygenxml работал и всё-таки dita тяжеловата, да и устарела она.

Недавно узнала, что есть расширение Google Docs, которое фигачит док в markdown, который перефигачивается в HTML. Хожу и радуюсь, век живи — век учись.

Дарья, вы о stackedit или ином?

Расскажите ищо, пожалуйста)

у нас довольно похоже.
доки в DITA.
оттуда экспорт в PDF (для клиентов пока так) и в webhelp для внутреннего использования.
дальше это пушится в GIT и там автоматом деплоится на внутренний сайт.

кастомизация под каждого клиента - не проблема. но множить все это по количеству клиентов и потом поддерживать - тяжко. хочется если отдавать наружу, то сразу по хорошему

1 ветка в гите - 1 клиент )

вопрос не в содержимом доки, а в доступе к её разделам. я наверное плохо знаю гит - как он может помочь с этим?

нужен раздельный доступ к разным файлам в зависимости от роли пользователя.

условный админ видит всё
условный бухгалтер видит только свое
условный клерк видит свое

при этом клерку могут изменить права. тогда сразу он должен начать видеть новые документы

а не ждать, пока мы вручную в их экземпляре доки поправим права и пересоберем вебхелп допустим

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

клерки не должны иметь доступ к правкам сорсов

дело не в правках. дело в просмотре

бухгалтеру не нужны настройки сети