I like the idea. I've seen it done as a "zreadme" method with the comments enclosed within #IF .F. and #ENDIF so you don't have to put an asterisk in front of every line. I think this technique came from one of the VFP frameworks but I don't know firsthand.

>Some class in the files section (I don't remember which) had a readme method that contained only comments for documenting the class. It seemed like a good idea to me, but I don't remember seeing it before or since. What do people think of the idea?