[Mono-list] Missing Types from corlib
04 Jan 2002 13:36:53 -0700
On Fri, 2002-01-04 at 08:40, Serge wrote:
> Maybe it's just me, but I think that such amount of attributes will quickly
> made the code unreadable.
> Remember, we practically decided not to use in-line XML comments to prevent
> intermixing the code with extra verbose info.
> But practically almost all modern editors allow folding of comment blocks
> (even vim has it now ;-) while for one-line attributes it's useless.
I could certainly add tags for this sort of information to the Monodoc
XML format if necessary.
Whether we use attributes or some other form of documentation, I plan to
have the documentation generators create maintainer, author, and todo
lists for types in an assembly.