X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=blobdiff_plain;f=mcs%2Fclass%2FREADME;h=efebe9ad5a9acc314ec75efbb1ffda5a9fb1ba7f;hb=b6513d2047228ee7ef7f50173bcc2432968b8e6e;hp=fbb7a68a101acb589ddfb362bfc05c1c2d133490;hpb=234225d112c4b018b8d1796f4c06a15812137500;p=mono.git

diff --git a/mcs/class/README b/mcs/class/README
index fbb7a68a101..efebe9ad5a9 100644
--- a/mcs/class/README
+++ b/mcs/class/README
@@ -25,6 +25,16 @@ testing.
 		throw new NotImplementedException ();
 	}
 
+	Ideally, write a human description of the reason why there is
+	a MonoTODO, this will be useful in the future for our
+	automated tools that can assist in developers porting their
+	code.
+
+	Do not use MonoTODO attributes for reminding yourself of
+	internal changes that must be done. Use FIXMEs or other kinds
+	of comments in the source code for that purpose, and if the
+	problem requires to be followed up on, file a bug.
+
 * Supporting .NET 1.2, .NET 1.1 and .NET 1.0 builds
 
 	The defines NET_1_1 and NET_2_0 are used to include