search

adam-singer / dart-carte-du-jour

Pub documentation generation system
www.dartdocs.org
Other
25 stars 8 forks source link

De-emphasize private declarations (beginning with undercore) #72

Closed skybrian closed 10 years ago

skybrian commented 10 years ago

For example, on this page [1] there is one public method (makeGif) and a bunch of private methods. I suppose it's somewhat useful to list the private methods, but it seems like they should be hidden or de-emphasized somehow?

[1] http://www.dartdocs.org/documentation/gifencoder/0.2.3/index.html#gifencoder/gifencoder

adam-singer commented 10 years ago

@skybrian we disabled the private options for builds going forward already https://github.com/financeCoding/dart-carte-du-jour/issues/55. A few people have mentioned this issue and we are debating if its worth doing a full rebuild of all packages at the moment. Might just let it float as is until more potential issues come in. Then any major refactors we could do a full rebuild if necessary. Otherwise might incrementally upgrade documentation builds with a single batch job. The only reason to wait on building all documentation at once is cost $$ efficiency.

adam-singer commented 10 years ago

btw, I fired off a rebuild for this package, should reflect soon.