Support for extension methods in dartdoc

[mit-mit]

@jcollins-g what's remaining here? Can you link this to more detailed issues for what has to get done?

---

(by @jcollins-g) :

Extension methods, due to the significant change in Dart scoping rules, has a huge impact on Dartdoc that wasn't originally anticipated. The main issues are listed below:

• Exported extensions don't show up in the docs for a library dartdoc#2032
• Reference links within extension methods are unimplemented dartdoc#2033
• Cross-link extensions on class where they apply dartdoc#2021
• Extension reexport doesn't handle name conflicts correctly dartdoc#2047

Some changes to the analyzer to provide more data so Dartdoc can discover extension methods in the reexport case are also needed for dartdoc to be correct on all edge cases.

[jcollins-g]

@mit-mit I assume you mean "Document" extension methods rather than "Dartpad"?

[mit-mit]

Sorry, bad copy-paste

[jcollins-g]

dartdoc 0.29.0 is coming in time for D27, and it will have the fix for dart-lang/dartdoc#2032. A partial fix for dart-lang/dartdoc#2021 should also land in time (dart-lang/dartdoc#2053).

[vsmenon]

Any update here?

[vsmenon]

Ping. Is there an update on what landed? (At least one of the unchecked issues in the first comment is now closed.)

Is there anything in flight that merits cherry-picking?

[vsmenon]

Also, have we pinned the latest dartdoc in Dart and Flutter DEPS?

[jcollins-g]

Fixes for dart-lang/dartdoc#2032 and dart-lang/dartdoc#2047, and a partial fix for dart-lang/dartdoc#2021 have landed and are pinned in Dart and Flutter.

I consider this a bare-minimum level of support for extension methods, and am currently focusing on NNBD support in Dartdoc before improving extension methods further.

[mit-mit]

Clearing milestone now that the must-do work for 2.7 is fine

[natebosch]

Where are we tracking the roll to a working version of dartdoc on the pub site?

[jcollins-g]

looks like dart-lang/pub-dev#3088