+1 for documentation.  would this play nice with some kind of auto doc thing?