Mmmh, la plupart des problèmes que tu cites sont exactes : la MSDN est limité à Internet Explorer, ce qui explique que tu ne puisse affichre le filtre par langage, que la police soit trop petite ou que l'indentation soit mal faite.
la navigation dans l'arborescence d'une API est mal foutue
Question de point de vue, perso j'aime bien voir les méthodes héritées directement comme toutes les autres méthodes, quand je consulte la doc d'une classe, c'est pour voir ce que je peux faire avec, pas ce qui lui est spécifique, c'est plutôt pénible de ce point de vue là dans la javadoc à mon goût.
on n'a jamais de page résumant toutes les méthodes, arguments, classes mères et classes filles d'une classe
En même temps je vois pas trop l'intérêt d'avoir tout celà sur la même page... Dans le cas de la javaDoc celà fait une page énorme et faut scroller à outrance je trouve.
je ne sais pas la taille que ça fait mais ça m'a l'air d'être tout un bordel là dedans
3 CD entiers. Je te laisse imaginer le boulot de traduction, sachant qu'il n'y a qu'une langue sur 3 CD ;)
la navigation est lente
C'est vrai qu'il y a une légère latence.
Bref bref, la MSDN a évidemment quelques défauts, la plupart étant liés à la version Web, mais il ne faut pas oublier que la majorité des développeurs a la version Offline qui n'a quasiment plus aucun des problèmes de naviguation/compatibilité/filtrage cités.
Sinon pour moi JavaDoc et la MSDN on la même vision d'une documentation et on peut naviguer à peu près de la même manière dans l'arboresence des classes. C'est pour celà que je trouvais la critique facile, d'autant plus que les 2 centre de documentation ne sont pas du otut à la même échelle, leurs contenus absolument pas dans les même proportions, les API, langages et articles étant en nombre beaucoup plus conséquent sur la MSDN.
[^] # Re: certes
Posté par TImaniac (site web personnel) . En réponse au journal Java, après pratique, je trouve ça à chier, vive .net. Évalué à 2.
la navigation dans l'arborescence d'une API est mal foutue
Question de point de vue, perso j'aime bien voir les méthodes héritées directement comme toutes les autres méthodes, quand je consulte la doc d'une classe, c'est pour voir ce que je peux faire avec, pas ce qui lui est spécifique, c'est plutôt pénible de ce point de vue là dans la javadoc à mon goût.
on n'a jamais de page résumant toutes les méthodes, arguments, classes mères et classes filles d'une classe
En même temps je vois pas trop l'intérêt d'avoir tout celà sur la même page... Dans le cas de la javaDoc celà fait une page énorme et faut scroller à outrance je trouve.
je ne sais pas la taille que ça fait mais ça m'a l'air d'être tout un bordel là dedans
3 CD entiers. Je te laisse imaginer le boulot de traduction, sachant qu'il n'y a qu'une langue sur 3 CD ;)
la navigation est lente
C'est vrai qu'il y a une légère latence.
Bref bref, la MSDN a évidemment quelques défauts, la plupart étant liés à la version Web, mais il ne faut pas oublier que la majorité des développeurs a la version Offline qui n'a quasiment plus aucun des problèmes de naviguation/compatibilité/filtrage cités.
Sinon pour moi JavaDoc et la MSDN on la même vision d'une documentation et on peut naviguer à peu près de la même manière dans l'arboresence des classes. C'est pour celà que je trouvais la critique facile, d'autant plus que les 2 centre de documentation ne sont pas du otut à la même échelle, leurs contenus absolument pas dans les même proportions, les API, langages et articles étant en nombre beaucoup plus conséquent sur la MSDN.