Improving documentation for built-in type declarations

Looking at for instance lib.dom.d.ts, what I notice is that the documentation isn't what it could be. Is there any policy w.r.t. improving on this? I think the benefits of better docs are quite obvious, for instance adding examples or stating browser support for certain features.

However I wonder if:

• Since the file is already quite large, and adding documentation could blow it up like 100x, would this cause any performance issues (in editors)? If so, is there a way around it?
• The best documentation on these things (that I know of) are on MDN. A nice start could be to link/auto add some docs from there, if the licensing allows it (https://wiki.developer.mozilla.org/en-US/docs/MDN/About#Copyrights_and_licenses). I think it does at least in part.

Inizia esaminando lib.dom.d.ts e le domande dell'issue riguardo alle dimensioni della documentazione, alle prestazioni dell'editor e alle licenze di MDN. Confronta le dichiarazioni esistenti con il materiale MDN citato. Questa issue sarà completa solo dopo che il progetto avrà concordato una policy per la documentazione e un approccio concreto e accettato.