slash_for_doc_comments

Prefira usar /// para comentários de documentação.

Do Effective Dart:

FAÇA usar /// para comentários de documentação.

Embora o Dart suporte duas sintaxes de comentários de documentação (/// e /**), preferimos usar /// para comentários de documentação.

BOM:

/// Parses a set of option strings. For each option:
///
/// * If it is `null`, then it is ignored.
/// * If it is a string, then [validate] is called on it.
/// * If it is any other type, it is *not* validated.
void parse(List options) {
  // ...
}

Dentro de um comentário de documentação, você pode usar markdown para formatação.

Para ativar a regra slash_for_doc_comments, adicione slash_for_doc_comments em linter > rules no seu arquivo analysis_options.yaml:

linter:
  rules:
    - slash_for_doc_comments

Se você usa a sintaxe de mapa YAML para configurar as regras de lint, adicione slash_for_doc_comments: true em linter > rules:

linter:
  rules:
    slash_for_doc_comments: true