À titre d'exemple, la documentation Python est parfaite (constatez que le document de référence ne se substitue pas au tutoriel et que, sans ce dernier, le premier reste difficile d'accès).
J'aime beaucoup python. Mais je ne peux pas te laisser dire cela. La doc Python est typiquement insuffisante: elle n'est justement pas exhaustive, on ne sait pas à quoi s'attendre comme retour, ni l'ensemble des valeurs possibles pour les paramètres, son périmètre d'utilisation, etc. Fouiller dans les sources pour savoir comment utiliser une méthode, ça va 5 minutes, mais ce n'est pas efficace.
Une bonne doc technique, je trouve, c'est la doc QT qui est, elle, vraiment bonne et agréable à utiliser. C'est simple : tu sais que tu vas trouver la réponse à ta question.
#tracim pour la collaboration d'équipe __ #galae pour la messagerie email __ dirigeant @ algoo
# Je ne peux pas laisser dire cela
Posté par LeBouquetin (site web personnel, Mastodon) . En réponse au journal Jacob Kaplan-Moss: Écrire une bonne documentation. Évalué à 2.
J'aime beaucoup python. Mais je ne peux pas te laisser dire cela. La doc Python est typiquement insuffisante: elle n'est justement pas exhaustive, on ne sait pas à quoi s'attendre comme retour, ni l'ensemble des valeurs possibles pour les paramètres, son périmètre d'utilisation, etc. Fouiller dans les sources pour savoir comment utiliser une méthode, ça va 5 minutes, mais ce n'est pas efficace.
Une bonne doc technique, je trouve, c'est la doc QT qui est, elle, vraiment bonne et agréable à utiliser. C'est simple : tu sais que tu vas trouver la réponse à ta question.
#tracim pour la collaboration d'équipe __ #galae pour la messagerie email __ dirigeant @ algoo