Hahó!
Nem csak SDK-ról, de pl. az API-ról (pontosabban a Java API-ról) szóló doksi (itt) felépítése számomra mérvadó (korábban SUN, most Oracle kezelésben), magam is az MSDN-t kissé átláthatatlannak, és hiányosnak érzem, pl. C# esetében.
+ Ilyen típusú doksit -- mint amilyen az API leírás -- a Java programokhoz generáltatni lehet a javadoc programmal.
>> Mi kell rá, mi nem?
Minden ami a megtanulásához (pl. működő és érthető példakódok) és a napi használatához kellhet (nyelvi és programkönyvtári referencia kézikönyv).
G.
P.S.
>> Na, senki sem olvas doksikat? Úgy születtetek, hogy mindent tudtok?
Nem feltétlenül a mindentudás birtoklása az ok, talán csak aki most dolgozik (fejleszt), az nem biztos, hogy épp most a HUP-ot is olvassa fejlesztés közben...
============================================
"Share what you know. Learn what you don't."