typedoc2md/typedoc-plugin-markdown

Add a `outputFileStrategy` for categories

Opened this issue · 1 comments

fb55 commented

What package is the feature request related to?

typedoc-plugin-markdown

Background

The Cheerio project has a core class with many, many methods. The methods are already grouped by category in the sidebar of the page, but it would be a big improvement if the page was split by category. Current issues include indexing issues from Algolia (the site search does not pick up the file as it is too large) and UX issues due to too much information being on the same page.

Proposed solution

Add a strategy to split classes by category. Alternatively, this might be another option similar to membersWithOwnFile (eg. categoriesWithOwnFile).

It might be nice to also switch between the strategies automatically, based on the number of entries on a particular page.

Thanks - this is an interesting idea. I'll try and find some time to do a bit of a spike on it.