The IDL is increasingly important, but it's too hard to find out what it supports. We were using scope docs, tests, and word of mouth as "temporary" documentation, but it's been a few years now, and IDL is growing in complexity and importance.

https://wiki.corp.mongodb.com/display/HGTC/Using+IDL+for+Code+Generation+in+the+Server