31.47 Flutter Lint Dangling Library Doc Comments

20220202

The lint rule dangling_library_doc_comments warns about library doc-comments (those that begin with three slashes ///) that do not belong to the imports or first block of code (the first declaration).

Historically the dart doc tool automatically treated the document comments as a library comment on coming across the first import in the file. If there were no imports though, the comment became a comment on the first declaration of the library, meaning that the comment was not shown as a library documentation.

A dart fix will automatically fix this issue. By adding the library; directive after the header batch of doc comments (///) the comments are attached to the library’s documentation.

---

Your donation will support ongoing availability and give you access to the PDF version of this book. Desktop Survival Guides include Data Science, GNU/Linux, and MLHub. Books available on Amazon include Data Mining with Rattle and Essentials of Data Science. Popular open source software includes rattle, wajig, and mlhub. Hosted by Togaware, a pioneer of free and open source software since 1984. Copyright © 1995-2022 Graham.Williams@togaware.com Creative Commons Attribution-ShareAlike 4.0