RE: [Ndoc-users] C# Documentation Markup language

[Trevor de K. <tre...@as...>]

  _____  

From: ndo...@li...
[mailto:ndo...@li...] On Behalf Of Bradley Ward
Sent: Thursday, April 27, 2006 12:41 PM
To: ndo...@li...
Subject: [Ndoc-users] C# Documentation Markup language



 >>  NDoc is great, but the actual markup language has a very high suckage
factor IMHO. I don't know why Microsoft could not use an existing language
(HTML) instead of making up their own suckly markup language. Oh well. off
of my soapbox. 

>>

 

Why on earth would you want to use HTML?  That limits your output to
well...HTML.  As XML your output can be formatted to just about anything
including HTML.  IMO an XML markup is far superior and gives rise to tools
like NDoc.  Moreover it gives semantic meaning to your markup so you can
make sense of it.  For example <param name="sender"></param> has to do with
parameters whereas <b>Parameter name = "something"</b> or something has no
semantic meaning other than that inferred by the author.

 

Cheers,

 

Trevor

 

 
Trevor de Koekkoek
http://www.aspevia.com <http://www.aspevia.com/> 
Google Sitemap generator: http://www.sitemagellan.com
<http://www.sitemagellan.com/>