Details:

• ☂️ Documentation imports dart-lang/sdk#56186
• Introduce a syntax for importing elements just for doc comment references dart-lang/sdk#50702

Related:

• Add a warning similar to UNUSED_IMPORT for doc imports that are unused. dart-lang/sdk#55414

Blockers:

• Cannot resolve top-level methods with docimports dart-lang/sdk#56088
• docImports failing to allow for resolution in some flutter animation library code dart-lang/sdk#56100
• Problems listed in Adding @docImports to the animation library #150798 (comment)
• references in docs on enum values (examples in Docimports for foundation #151119 (comment))
• references to library names (Reference libraries with @docImports dart-lang/sdk#56528)
• cross-references between packages without dependency (example in docImports for flutter_test #151189 (comment))
• comment_references has trouble with images and links dart-lang/sdk#57104
• google3 problems docimporting flutter_test from pkg:flutter
• as imports do not work (@docImports should support as imports dart-lang/sdk#56527)
• dartdoc and comment_reference disagree: https://github.com/flutter/flutter/pull/151951/files#r1682709050
• typedefs (Doc comment references cannot resolve an extension member when prefixed by the extended type's name dart-lang/sdk#56109)