Writing documentation; requirements, design and user documents is hard. I don't expect this to change any time soon.
However, proc documentation is inceredibly easy to write, hard to get out of sync, and serves the main ACS audience at the moment, programmers, very well.
Note when porting: gratuitous use of the Tcl namespace feature has broken proc documentation for what little exists. Be careful where you eval ad_proc.
