dotnet / dotnet/docfx

Custom grouping for API reference

Open
#1,693 1 comment 5 reactions 0 assignees View on GitHub
dotnet
Dominant language
C#
Stars
4.4k
Forks
890
Avg merge
2h 11m
Merged PRs (30d)
10

Description

I was advised to post my scenario here as issue:

I want different projects (and also different GIT repositories) to be merged by a so-called *CategoryAttribute*. So instead of, let's say:

```
+ A.A
- ClassT (attributed with X)
+ A.B
- ClassT (attributed with Y)
+ B.A
- ClassT (attributed with Y)
+ B.D
- ClassT (attributed with X)
```

I want a grouping like this:

```
+ X
- A.A.ClassT
- B.D.ClassT
+ Y
- A.B.ClassT
- B.A.ClassT
```

This would allow to have a set of APIs sorted by "use case" instead of real project hierarchy. Especially helpful for products that want to integrate with plugins/addins to their ecosystem.

Is that possible somehow?

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.