『///』について。【Flutter】

Question

『///』の用途を教えて頂きたいです。
文字が緑になります。

//todo ~~ の**『//』**とは、また別の用途の記号なのでしょうか？

---

メモ書きの為に使うのかと思いましたが、
実際使ったところ、Positionedの sに謎の下線が引かれてしまいました。(※下記スクリーンショット参照)

---

お時間あるときにご返信いただければ、幸いです。

Answer 1

//や/* */は通常のコメントで、///や/** */は、ドキュメントコメントといって、Dartが見つけてドキュメント化してくれます。ドキュメントコメントはMarkdown形式で記述することが可能です。

/// 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) {
  // ...
}

https://dart-lang.github.io/linter/lints/slash_for_doc_comments.html

Comments

[kazuki_user]

迅速なご回答ありがとうございました????