>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?

It's a good idea. I myself call this method zabout so it is the last one in property sheet.