Управляющая иерархия документации API по проекту SHFB - PullRequest
0 голосов
/ 26 сентября 2018

У меня есть один проект C #, который содержит API, который служит «фасадом» для стороннего продукта, напрямую ссылаясь на его библиотеки DLL.Поскольку необходимо поддерживать один и тот же API-интерфейс, совместимый с двумя версиями этого стороннего продукта, я добавил в решение второй проект со ссылками, указывающими на более новый сторонний продукт, включая все файлы кода из первого проекта «какссылка на сайт".Оба проекта имеют одинаковое имя и одинаковые функции, они просто ссылаются на разные

Когда я хотел использовать в своем решении построитель справочных файлов SandCastle (SHFB), я добавил в решение новый проект SHFB.Затем в «Источниках документации» я добавил два источника документации, по одному для каждого проекта API.

Однако, когда я генерирую документацию, SHFB организует ее по пространству имен.Поскольку код такой же (из-за файлов, добавленных в виде ссылки), я получаю файл CHM со сводкой, такой как:

Пространство имен A
|
+ Интерфейс IAAA
||
|+ Методы IAAA
|+ Свойства IAAA
|
+ Класс AAA
|
+ Методы AAA
+ Свойства AAA

Однако я хотел бы иметь иерархический уровень над пространством имен, определяющийцелевая сторонняя библиотека, например:

API PRODUCT 1.0
|
+ Пространство имен A
|
+ Интерфейс IAAA
||
|+ Методы IAAA
|+ Свойства IAAA
|
+ Класс AAA
|
+ Методы AAA
+ Свойства AAA
ПРОДУКТ API 2.0
|
+ Пространство имен A
|
+ Интерфейс IAAA
||
|+ Методы IAAA
|+ Свойства IAAA
|
+ Класс AAA
|
+ Методы AAA
+ Свойства AAA

У кого-нибудь есть идеи, как этого добиться?

Спасибо

...