{@template} docs not showing up in base class

[tvolkert]

Flutter's WidgetsApp.localizationsDelegates uses {@template} to set up a reusable documentation block for subclasses:

  /// {@template flutter.widgets.widgetsApp.localizationsDelegates}
  /// The delegates for this app's [Localizations] widget.
  ///
  /// The delegates collectively define all of the localized resources
  /// for this application's [Localizations] widget.
  /// {@endtemplate}
  final Iterable<LocalizationsDelegate<dynamic>> localizationsDelegates;

The documentation that's produced for the base class is empty: https://docs.flutter.io/flutter/widgets/WidgetsApp/localizationsDelegates.html. Note that subclasses that use the {@macro} do get the correct documentation inserted.

It seems that {@template} documentation blocks should still show in the generated documentation.

/cc @jcollins-g

[jcollins-g]

This has been WAI but is very counterintuitive, and I don't like the idea of having to repeat a macro declaration to work around it.