The contribution guide on 'namespacing' seems outdated: https://github.com/borisyankov/DefinitelyTyped/wiki/How-to-contribute#namespacing

I looked around the repo and the structure of the declarations is unclear.

Could be cool to add a markdown-document and/or some example files to show how to make a really good definition file.

Should cover some practical stuff:

• support current TypeScript version ~0.9.5 (or 1.0-ish?)
• work with import
• declare "module"
• no global-namespace pollution
• work for node modules
• work in browser code
• ... ?