Warn about comments between docstring and the documented object?

[mgkurtz]

I was quite puzzled to find out, that comments between docstrings and the documented objects are disallowed. As where @pfitzseb and @simeonschaub in JuliaDebug/JuliaInterpreter.jl/issues/538. This is actually the documented behavior and was discussed some time ago. But besides @JeffBezanson’s argument, that “it would be pretty confusing if a string still acted as a doc string despite any number of intervening blank and comment lines” the discussion did not cover the point of comments between doc string and documented object.

"The great foo"
# TODO: Implement this properly.
foo = 42

Here "The great foo" does nothing at all. So I wonder, whether code, that does nothing but has a chance to have been intended to do something (document foo) could perhaps throw a warning? That could help confused people like me, to find out, what they did wrong.