in cfscript does anyone use the

hint=""

attribute when declaring method arguments vs a javadoc comment block above the method? i find that with whatever extension i have installed is ultimately handling the hover dialog and what it displays (i.e., when you hover over a function call and it displays the method's signature and docs) that this dialog will ONLY ever display each argument's hint only if it's expressed as a

required string argumentName hint="explanatory text"

attribute. which is pretty frigging gross vs javadoc.

I've used JavaDoc comments for many years. I also recently started using DocBox by Ortus, with some of their additional annotations (although html in comments is ugly 🤮). https://www.ortussolutions.com/blog/documenting-cfml-with-docbox