Implement the Q1 2021 small features release in dartdoc.

[leafpetersen]

This tracks implementation work for this feature set.

cc @devoncarew @jcollins-g @franklinyow

Individual feature tracking:

• Type arguments on annotations: Add support for type arguments on annotations dartdoc#2516
• >>> as an overridable operator: Allow >>> as an overridable operator. dartdoc#2518
• Generic function types as type arguments: Allow generic function types as type arguments dartdoc#2517

[leafpetersen]

@jcollins-g any updates here?

[jcollins-g]

This work is just starting.

[jcollins-g]

This is unlikely to be complete within one week; at most, code will be landed for 1 or 2 out of three by this point.

[devoncarew]

@leafpetersen - do you have a sense for in which order we should tackle these in?

[leafpetersen]

What's the existing status for each of them? That is, does dartdoc crash, or just generate sub-optimal docs or something else? It looks like unsigned shift is documented on int now, but the link doesn't work? How about the rest?

[devoncarew]

dartdoc support is still in progress; generally:

• generic functions as type arguments does not crash but isn't yet fully functional
• generic-metadata support seems to be "fine" on first inspection and does not crash; some bits landing now will help it approach something more stable
• triple shift seems to be fine; we're less worried here

[jcollins-g]

dartdoc support is still in progress; generally:

• generic functions as type arguments does not crash but isn't yet fully functional
• generic-metadata support seems to be "fine" on first inspection and does not crash; some bits landing now will help it approach something more stable

This assumes we get another analyzer publish on time; currently published analyzer does crash here.

• triple shift seems to be fine; we're less worried here

[leafpetersen]

Tentatively marking triple shift and generic metadata as done since the linked bugs have been closed, any remaining work on those two?

[jcollins-g]

Yes. dartdoc must be published and rolled through the ecosystem (working on that today). The analyzer must also be published.

[jcollins-g]

The urgency on this has decreased somewhat, but here are the CLs for the SDK and flutter. The first two checkmarks can be considered "done" at the point these land (edit: and the analyzer is published).
https://dart-review.googlesource.com/c/sdk/+/194011 : CL for dartdoc in SDK
flutter/flutter#79795 : CL for dartdoc in flutter

[leafpetersen]

Any updates? FYI, the flag flip CLs have now landed in master (this doesn't affect the timing of this issue, just FYI).

[jcollins-g]

dart-lang/dartdoc#2625 brings dartdoc back to where it was before the feature was punted out. No further updates for now.

[franklinyow]

Any update?

[jcollins-g]

I'll look into this this week; remaining work is expected to be small.

[franklinyow]

@leafpetersen Looks like the last pieces is done. Ready to close this?

[jcollins-g]

@franklinyow The change just landed inside Dartdoc; I would prefer it to propagate to the Dart SDK and Flutter before closing this issue. That will likely happen Monday.

[jcollins-g]

Going to close this as it looks likely that Flutter will finish landing shortly. Small features is done for dartdoc.