flutter - dart - 评论中模板和宏的命名约定是什么

Question

Dart 具有dartdoc文档语法{@template}和{@macro}. 我想知道是否有它的命名约定。在文档中，他们只给出了in 中的{@template template_name}示例snake_case。

现在，我将我的模板命名为：

{@template project_name.class_name.method_name}（snake_case用 分隔.）。

例如项目project_name：

文件class_name.dart

/// {@template project_name.class_name}
/// ...
/// {@endtemplate}
class ClassName {
  /// {@template project_name.class_name.method_name}
  /// ...
  /// {@endtemplate}
  void methodName() {}
}

我想知道这些模板名称是否已经有一些约定？