Home > other >  Flutter/Dart Formatting for in-line Documentation Comments?
Flutter/Dart Formatting for in-line Documentation Comments?

Time:11-23

Are there additional formatting options for Flutter/Dart in-line documentation?

I'm using Android Studio. I prefer to leave detailed comments so I don't have to spend time looking through code to figure out why a specific class or method was used. In C#, I use the triple-slash (///) with to add in-line documentation. I know Dart uses the triple-slash as well, but slightly differently than C#. For instance, Dart doesn't support the Summary, Para, nor Param tags.

From what I have found, Dart uses the following:

Of course, triple-slash (///) is a basic in-line documentation comment

/// My Documentation Comment

I've found that you can use plus ( ) or minus (-) to indicate an item in a bulleted list:

/// - Bullet List Item 1
///   Bullet List Item 2

You can also use Hash (#) for emphasizing a line.

/// # This Line will be Emphasized

Lastly, it supports the BR tag for new line in comments.

/// This is line 1 
/// This will also appear on line 1
/// <br /> This will appear on line 2

Apart from these 4, are there any other formatting options that can be performed when working with in-line documentation in Dart?

CodePudding user response:

Use TODO in Comments. The TODO will make it highlight and accessible

///TODO:something in comment

This works fine with android studio

CodePudding user response:

Dartdoc uses Markdown, so you can use most typical Markdown formatting in Dartdoc comments.

  • Related