La documentation selon Microsoft

Crédits : photo-libre.fr
Il m’arrive de développer avec des technologies Microsoft. Ce n’est pas que ça me plaise particulièrement, mais quand on me le demande gentiment je ne refuse pas.
Il arrive même que ces technologies soient plutôt agréables à utiliser. La plateforme .NET ne manque pas de charme par certains aspects. Il faut bien l’avouer. Et puis surtout, elle est bien documentée. Le site MSDN est vraiment complet, on y trouve à peu près tout ce qu’on cherche.
Sauf si on utilise un langage un peu démodé. Par exemple : VB6. Et oui, MSDN ne parle que de VB10. « Places au jeunes ! ». Et du coup, on est bien embêté. Et il faut faire avec les moyens du bord quand il s’agit de se documenter sur une fonction particulière.
Une première solution consiste à utiliser un moteur de recherche douteux pour trouver ce dont on a besoin. Le risque est de voir apparaître 95% des résultats pointant vers des sites pas cool du tout, avec des gens qui « postent leur premier code source alors soyez indulgents », et d’autres qui critiquent mais qui manifestement ne s’y connaissent pas plus.
Une deuxième solution est de se souvenir qu’à une époque l’Internet était lent et peu garni. Du coup, les gens regardaient dans la rubrique « Aide » du logiciel. Pour VB6, cette documentation est très bien intégrée à l’IDE Visual Basic. Il suffit de faire un clic-droit sur la fonction qui nous intrigue, de cliquer sur « Définition », et paf une documentation, sommaire mais pratique, s’affiche.
Sauf que dans certains cas, on y découvre des plaisanteries typiquement Microsoft : par exemple si on cherche la documentation de la méthode « Hide » des Forms.

"Impossible d'aller à Hide qui est caché"
C’est d’une logique implacable. Hélas, si on essaie avec la méthode « Show », le résultat ne prend pas un air plus intelligent :

"Impossible d'aller à Show qui est caché"
Nous voilà bien avancé maintenant.
Commentaires récents