Il est vrai que la MSDN fournit pas mal d'exemples et aide beaucoup les débutants (traduction, liens vers des classes associées).
Cependant je lui trouve plusieurs défauts :
- quand on affiche une classe, on a la doc de tous les langages, et c'est pas super lisible (écrit trop petit par ex)
- ces exemples de code sont très mal indentés dans Firefox
- la navigation dans l'arborescence d'une API est mal foutue (interfaces/classes abstraites/packages tout ça ne saute pas immédiatement aux yeux)
- on n'a jamais de page résumant toutes les méthodes, arguments, classes mères et classes filles d'une classe
- les URLs directes sont difficilement lisibles et utilisables par le commun des mortels
- je ne sais pas la taille que ça fait mais ça m'a l'air d'être tout un bordel là dedans (ça tient sur un CD ?)
- la navigation est lente (entre autres synchro avec la TOC)
A côté de ça, la JavaDoc pêche de ces côtés-là :
- manque de tutoriaux simplement accessibles depuis la javadoc (les tutoriaux sont à l'extérieur de la javadoc, bien qu'ils soient librement téléchargeables)
- manque de traductions
- pas d'explications pour débutants
Mais avec qq années de Java derrière moi et qq mois de C#, je préfère bien évidemment la JavaDoc. Mon avis aurait peut être été différent si j'avais fait 3 ans de VB :)
[^] # Re: certes
Posté par Pierre Tramonson . En réponse au journal Java, après pratique, je trouve ça à chier, vive .net. Évalué à 3.
Cependant je lui trouve plusieurs défauts :
- quand on affiche une classe, on a la doc de tous les langages, et c'est pas super lisible (écrit trop petit par ex)
- ces exemples de code sont très mal indentés dans Firefox
- la navigation dans l'arborescence d'une API est mal foutue (interfaces/classes abstraites/packages tout ça ne saute pas immédiatement aux yeux)
- on n'a jamais de page résumant toutes les méthodes, arguments, classes mères et classes filles d'une classe
- les URLs directes sont difficilement lisibles et utilisables par le commun des mortels
- je ne sais pas la taille que ça fait mais ça m'a l'air d'être tout un bordel là dedans (ça tient sur un CD ?)
- la navigation est lente (entre autres synchro avec la TOC)
A côté de ça, la JavaDoc pêche de ces côtés-là :
- manque de tutoriaux simplement accessibles depuis la javadoc (les tutoriaux sont à l'extérieur de la javadoc, bien qu'ils soient librement téléchargeables)
- manque de traductions
- pas d'explications pour débutants
Mais avec qq années de Java derrière moi et qq mois de C#, je préfère bien évidemment la JavaDoc. Mon avis aurait peut être été différent si j'avais fait 3 ans de VB :)