@technomancy documentation belongs in the code tree, and should be treated like the rest of code: reviewed, then merged.