typedoc-plugin-markdown icon indicating copy to clipboard operation
typedoc-plugin-markdown copied to clipboard

Support `@groupDescription` tag for vitepress theme

Open hntrl opened this issue 7 months ago • 1 comments
trafficstars

What package is the feature request related to?

typedoc-vitepress-theme

Background

Right now with the vitepress theme I can provide a @packageDocumentation or @module tag to add additional docs that's separate from the package README, and it will add it to the package index page.

Image

If I wanted to add similar documentation for groups, I'd expect that I can use the @groupDescription tag to include it.

Image

Instead what I have to do is hoist what would be that reference page out to a different file like this. If I could describe that in the group description and have that section be a backlink to the auto generated typedoc page, that would be ideal.

https://hntrl.github.io/eventkit/ https://github.com/hntrl/eventkit/

Proposed solution

When a groupDescription tag exists, it should render a page that can be accessed in a similar fashion to when you use packageDocumentation.

hntrl avatar Apr 15 '25 19:04 hntrl

Hi,

Thanks - this looks like a very similar request to an issue already raised with TypeDoc itself https://github.com/TypeStrong/typedoc/issues/2893.

Will monitor that issue and will attempt to align behaviour if there is a resolution.

tgreyuk avatar Apr 15 '25 20:04 tgreyuk