missing_code_block_language_in_doc_comment

コードブロックに言語が指定されていません。

必ずドキュメントコメントのコードブロックで使用されている言語を指定してください。

Markdown コードブロックの適切な構文ハイライトを有効にするために、dart doc は、コードブロックの最初のコードフェンスの後に使用されている言語を指定することを強く推奨します。

dart doc でサポートされている言語のリストについては、highlight.js を参照してください。構文ハイライトを無効にする場合、または適切な言語がない場合は、言語として none を指定できます。

悪い例

/// ```
/// void main() {}
/// ```
class A {}

良い例

/// ```dart
/// void main() {}
/// ```
class A {}

missing_code_block_language_in_doc_comment ルールを有効にするには、analysis_options.yaml ファイルの linter > rules の下に missing_code_block_language_in_doc_comment を追加します。

linter:
  rules:
    - missing_code_block_language_in_doc_comment

代わりに YAML マップ構文を使用してリンタルールを設定している場合は、linter > rules の下に missing_code_block_language_in_doc_comment: true を追加します。

linter:
  rules:
    missing_code_block_language_in_doc_comment: true