Difference (last change) (no other diffs, normal page display)
== More Information =|
== Examples =
Put your comments about the official/non-official page here.|
Add your comments here...|
=== Embedding code in HTML is bad ===
== Amendments =|
You may add a link to this page on the DocumentationAmendments page to draw extra attention to your suggestion.
See the corresponding page in the D Specification: DigitalMars:d/html.html |
Corresponding page in the D Specification|
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