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?