In reply to Dovy.

Agreed. One of the problems with WordPress has always been the lack of documentation. New features are added regularly and developers are left to guess how to use them. One of such examples is the 3.5 media modal, which has no proper documentation yet, apart from some comments in the code itself.