Self Documenting Code
Of course code doesn't document itself but you can get a long way there by following a couple of simple rules and applying a few lines of PERL script. OK before I start rambling on here is an example of what can be achieved.
Examples for IE4 and IE5 are at the right. This uses a PERL script to strip comments and metrics from an ASP file and generate XML dynamicaly. I used all of the ASP files from the AdvWorks MS example site and included AAAExample.asp to try and show a greater range of capabilities.
As you can see there are a few bugs in this demo still especialy where asp code is used to generate image names etc.
All of the metrics : Session Variables Used, Session Variable Set, Redirections and Images are generated automaticaly by the perl script. The comments must be included explicitly as in AAAExample.asp.
Download it here.