Anecdotally, I've noticed more frequent doc comments in languages that put them inside the function (e.g. Python, Lisp) rather than outside (JS, Rust).
Perhaps it's easier to write the rough signature before the explanation?
miniblog.
Related Posts
I see people advocating for writing a FAQ, but I really struggle to write one from scratch.
The best FAQs are written as a response to, well, frequent questions.
How do you populate the initial FAQ?