I am now doing this. It's amusing to see all the reserved words (about half of the words) colored blue in my documentation.
>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
>
>>Some class in the files section (I don't remember which) had a readme method that contained only comments for documenting the class