Комментарии (//)
Комментарии обычно используются для комментирования некоторой части вашего кода или добавления некоторых комментариев в ваш код, которые вы хотите сообщить своим товарищам по команде.
Do c Комментарии (///)
Do c Комментарий предназначен для целей документирования. Dartdo c анализирует c комментариев и создает страницы документации.
+--------------------------------------------+-----------------------------------------------------+
| Comments | Doc Comments |
+--------------------------------------------+-----------------------------------------------------+
| - Comment out some part of your code | - Anything that you want to document using dartdoc |
| - Private APIs | - Usually used for public API/Framework/Library |
| - Private variable declaration | |
| - Method implementation logic | |
| - Something you need to do in future | |
| for improvements or cleanup purpose etc | |
+--------------------------------------------+-----------------------------------------------------+
Подробнее об этом можно прочитать в Effective Dart - Documentation