So one interesting thing about our docs is that we already provide a lot of the information you might need for reasonable code hinting, and it's possible to export our docs as XML (atm, it might be a bit of a pain to extract the details out of the rdoc descriptions, but that's going to change with YARD).
Does that help?
--
Yehuda Katz
Developer | Engine Yard
(ph) 718.877.1325