-
Notifications
You must be signed in to change notification settings - Fork 133
Closed as not planned
Labels
P3A lower priority bug or feature requestA lower priority bug or feature requestcustomer-flutterIssues originating from important to FlutterIssues originating from important to Fluttertype-enhancementA request for a change that isn't a bugA request for a change that isn't a bug
Description
Sometimes there are docs of this style:
/// Foo bar.
///
/// Used by the [baz] to do [quux].
///
/// Bla bla.
Bar foo();
It would be nice if instead the docs looked like this:
/// Foo bar.
///
/// @inserts
///
/// Bla bla.
Bar foo();
// ...
/// The baz of the quux.
///
/// @insert in foo: Used by the [baz] to do [quux].
void baz();
This would help with the problem where baz changes later to not use foo, and now we have out of date stale documentation.
This is based on an idea by @yjbanov .
yjbanov
Metadata
Metadata
Assignees
Labels
P3A lower priority bug or feature requestA lower priority bug or feature requestcustomer-flutterIssues originating from important to FlutterIssues originating from important to Fluttertype-enhancementA request for a change that isn't a bugA request for a change that isn't a bug