search

dart-lang / dartdoc

API documentation tool for Dart.
https://pub.dev/packages/dartdoc
BSD 3-Clause "New" or "Revised" License
467 stars 118 forks source link

dartdoc should preserve some ordering of methods, classes, and libraries #1551

Open jcollins-g opened 6 years ago

jcollins-g commented 6 years ago

There's a general theme in this old doc that it's unfortunate that dartdoc organizes code in a way that's not under user control. However, it's really nice to have docs that are sorted in some way (alphabetical, for example).

A design to deal with this problem probably should include refactoring tools that assist the user in organizing code. If a refactoring tool existed to sort libraries in the same order that dartdoc used to use, and it was possible to say, drag and drop to reorganize methods, constants, etc inside the structure view in IntelliJ, it'd be reasonable to drop dartdoc sorting and leave it to the user to organize their code in a way that makes sense.

jaumard commented 4 years ago

It would be indeed nice to be able to choose the oder of classes and methods, some might be more important than other. Having the possibility to customize this in dartdoc_options.yaml or in other way is needed.

c1avie commented 3 years ago

How to get rid of alphabetic sorting in dartdoc_options.yaml？