Have an option to generate docs without categories

[HosseinYousefi]

Currently in order to generate general docs about the usage of a package, we're using categories. These categories are then generated as "topics" only if we actually use them inside the doc comments like {@category xyz}. It would be nice if we have an option to have general docs that we can add as .md files by adding them to dartdoc_options.yaml without specifying them inside the source as well.

cc @jonasfj

[srawlins]

Thanks for filing a bug! Is this the same as #1096?

[HosseinYousefi]

It is similar. We could use the same category mechanism as far as I'm concerned in this issue without having to manually add all the categories to the main library for example:

/// {@category foo}
/// {@category bar}
library;

There is a showUndocumentedCategories option but that doesn't do this.