[Mono-dev] MonoTODO attribute usage policy.

[Miguel de Icaza]

Hello,

    MonoTODO attributes have been used in the past for two purposes: to
warn us about things that must be reviewed (this shows up on the class
status pages) and for comments that a developer would use.

    Since the Mono Meeting, we discussed using MonoTODOs instead as a
mechanism to provide a textual description that would assist a developer
that might use the API.  So the description should now be only to be
consumed by a user of the API (this is what we actually had documented
in the Wiki).

    This means that implementation notes like "We should improve X or
Y", do not belong in MonoTODO attributes.  Use "FIXME" strings on the
code, or if the issue is one worth following up with, then file a bug in
Bugzilla.

    I have updated the 

	http://www.mono-project.com/Coding_Guidelines

    page.

Miguel.