[Mono-list] Class Library coding standards
Miguel de Icaza
19 Jul 2001 14:07:05 -0400
> While we're all talking about this, is anyone XML doc commenting their code?
> Should we be, or is that going to be done by someone who works on
> documenting for the SDK docs? If we should now, is there a format we should
> stick to?
I like more the XML-style than the SDK style.
ie, XML (ie, I like more).
// This is a really nice summary. It is nice because I wrote it.
// I wish other summaries were as nice as I am.
ie, .NET SDK (ie, do not like)
// I am an ugly looking summary</summary> <return-value>god, what do
// I return?</return-value>
I am exagearating a bit, but you get the idea.