Further improved "document" documentation.

I'm afraid the codebase remains tragically broken. We're incrementally
inching toward a comprehensive, if reprehensible fix. Viva la
incroyable danger!