-
Notifications
You must be signed in to change notification settings - Fork 124
Divide the packages by category in the left sidebar #1118
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Comments
common to what? :) |
Flutter has ~37 libraries in its main doc page now: http://docs.flutter.io/flutter/. We could benefit from some type of categorization. Perhaps something like |
How is this different from --use-categories? It is a little wonky in edge cases but tries to do that. |
Do we have docs/examples for The last time I looked into this, I wanted to be able to have arbitrary groupings of libraries (like the ones Shams proposed), and I couldn't figure out how to do it. |
http://docs.flutter.io uses --use-categories. Without it the left column on that page would be a flat list of libraries. It's generated by a script in flutter. |
Changes to the new dartdoc in 0.11.0 include a --category-order flag which can give you some control over where libraries appear, but it might not be quite what this is looking for. |
So I believe that part (all?) of this has landed, judging from the looks of https://api.dartlang.org/dev:
The original comment of this issue suggested a category name ("Common") for the top-level group. Could we have a category name for this group? Maybe one of:
cc @kevmoo |
Looks like #1610 is a duplicate of this. The current implementation is malleable; it's possible to for me to add a configuration option in dartdoc_options.yaml that defines the name of the default category. |
Perhaps:
COMMON LIBRARIES
dart:async
dart:core
etc
HTML LIBRARIES
dart:html
etc
I/O LIBRARIES
dart:io
etc
@kwalrath
The text was updated successfully, but these errors were encountered: