Add your comments here...
[ Tsahi Asher: ] Embedding code in HTML is bad because:
- as a programmer, I want to code, not write HTML. The compiler, or some other utility like JavaDoc, should create the HTML out of the comments
- Doxygen is (somewhat) available for D too, this is for a different purpose
- code embedded in HTML is not readable
- There is a compiler flag (at least in GDC) to extract the code from the HTML