Hehe, at first seeing the subject line I thought somebody had found something offensive in our documentation and wanted to complain :D
Yes, more docs are good docs, especially if possible to extract automatically from one place to another! I'd love to see the mod.txt or code in modules...