dart-lang / sdk

The Dart SDK, including the VM, JS and Wasm compilers, analysis, core libraries, and more.
https://dart.dev
BSD 3-Clause "New" or "Revised" License
10.18k stars 1.56k forks source link

Let analyzer detect out of scope references in non-doc comments #38767

Open bergwerf opened 5 years ago

bergwerf commented 5 years ago

I often use [reference] in my comments to refer to fields or variables. Sometimes when I refactor the analyzer helps to remind me that I have to update some comments. Unfortunately this does not work for non-documentation comments (i.e. //).

srawlins commented 3 years ago

CC @jcollins-g

jcollins-g commented 3 years ago

this is something I do too. It would be nice if all comments were treated as documentation comments for this purpose, as sometimes even if it will not result in documentation, having the links for code navigation in IDEs is nice.