Separate hand written specification is rulez for human. It is best short module description (with some useful manually written comments). I like it more then autogenerated docs (by doxygen and so on).
I agree for C/C++ and even for D, but D's module capabilities make auto-generation of the same thing possible,
which is a very good thing. Now we need to make it work :)
