generated docs for flutter plugins also include the dart: docs

[devoncarew]

See https://www.dartdocs.org/documentation/url_launcher/0.4.1/ for an example.

[jcollins-g]

This is a dartdocs.org bug, but exactly what sort of dartdocs.org bug is not clear to me.

My guess is this probably has something to do with flutter shipping their own SDK and dartdocs.org not excluding the flutter SDK explicitly on the commandline (or incorrectly including it).

[jcollins-g]

The inclusion of dart:ui in the generated docs would seem to confirm this hypothesis.

[jcollins-g]

https://www.dartdocs.org/documentation/url_launcher/0.4.1/log.txt

The log suggests dartdoc is not recognizing that the flutter SDK isn't part of the package. But why isn't quite as clear.

[mit-mit]

@jcollins-g in case you need a local repro, these steps work for me:

git clone https://github.com/flutter/plugins.git
cd plugins/packages/url_launcher/
export FLUTTER_ROOT=<path to where you have flutter>/flutter
dartdoc

[mit-mit]

Any news @jcollins-g?

[jcollins-g]

I can reproduce it and am working on a set of command line flags for you to use to work around while I come up with a more permanent fix.

[jcollins-g]

@mit-mit work around with the following command line flag:

--exclude dart.collection,dart.math,dart.core,dart.developer,dart.io,dart.ui,dart.isolate,dart.convert,dart.async,dart.typed_data

This will be safe to use with and without the real fix to this problem.

[jcollins-g]

demoting to P2 since there is a workaround, but will still try to get this fixed soon.