Support custom categories for libraries within a package – and the SDK

[kevmoo]

Allow organizing the libraries (on the left side of nav) into custom categories

Blocking dart-lang/sdk#32297

[jcollins-g]

marking as P2 based on dartdoc triage priority (enhancements considered important but with no data indicating they are a big win)

[kevmoo]

I'd argue for P1 just because we are moving some dart: apis from core to VM – mirrors and isolates – and we want to help folks understand where they can be used!

[jcollins-g]

Didn't realize/see this was blocking a P1 bug on the SDK side. Agree then with prioritization: moving to P1 and will address after strong mode changes land.

[kevmoo]

Thank you!

…

On Mon, Feb 26, 2018 at 9:37 AM, jcollins-g ***@***.***> wrote: Didn't realize this was blocking a P1 bug on the SDK side. Agree then with prioritization: moving to P1 and will address after strong mode changes land. — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#1610 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AABCigqwRIESHFijWLA84TW6l_kCDGFsks5tYuvJgaJpZM4SRbfj> .

[jcollins-g]

@kevmoo Just to let you know I haven't forgotten this. With #1625 out of the way, now working on a steel thread through dartdoc to make dartdoc_options.yaml real. But before I get much further, I'll outline the planned outcome:

dartdoc_options.yaml will understand (for now) exactly two fields, one for listing the subcategorization, and another for sorting the subcategories.

Then we drop a dartdoc_options.yaml into the SDK like so:

dartdoc:
  subCategoryOrder: ['VM', 'Web']
  subCategories:
    VM: ['dart:io', 'dart:cli']
    Web:
      - 'dart:html'
      - 'dart:indexed_db'
      - 'dart:js'
      - 'dart:js_util'
      - 'dart:svg'
      - 'dart:web_audio'
      - 'dart:web_gl'
      - 'dart:web_sql'

Dartdoc will show uncategorized items in the sidebar first, then will organize the others as listed under subheadings.

[kevmoo]

Ack. Thanks!

…

On Wed, Mar 14, 2018 at 2:35 PM jcollins-g ***@***.***> wrote: @kevmoo <https://github.com/kevmoo> Just to let you know I haven't forgotten this. With #1625 <#1625> out of the way, now working on a steel thread through dartdoc to make dartdoc_options.yaml real. But before I get much further, I'll outline the planned outcome: dartdoc_options.yaml will understand (for now) exactly two fields, one for listing the subcategorization, and another for sorting the subcategories. Then we drop a dartdoc_options.yaml into the SDK like so: dartdoc: categoryOrder: ['VM', 'Web'] categories: VM: ['dart:io', 'dart:cli'] Web: - 'dart:html' - 'dart:indexed_db' - 'dart:js' - 'dart:js_util' - 'dart:svg' - 'dart:web_audio' - 'dart:web_gl' - 'dart:web_sql' Dartdoc will show uncategorized items in the sidebar first, then will organize the others as listed under subheadings. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#1610 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AABCitmYGRKbp6q5Ttls66Y3UX1Uw_9mks5teY0MgaJpZM4SRbfj> .