En comparaison la documentation de OCaml est beaucoup plus simple. Elle est écrite de façon assez "matheuse" mais à un niveau beaucoup plus élémentaire: le côté matheux de la documentation est plutôt utilisé pour décrire brièvement une fonction par une phrase générale qui inclut aussi les cas particuliers (de type liste vide, etc.). Après pour l'exemple que tu cites, je ne sais pas ce qui pousse les gens à écrire des documentations comme ça... je ne dis pas que les phrases "Formally, the class Bifunctor represents a bifunctor from Hask -> Hask. Intuitively it is a bifunctor where both the first and second arguments are covariant." ne sont pas intéressantes mais elles sont plutôt à mettre en remarque, ou en tout cas, après la description de ce que "font" concrètement les fonctions du module.
[^] # Re: Le code impératif
Posté par Michaël (site web personnel) . En réponse au sondage Ce que je déteste le plus en informatique / programmation / codage c'est... :. Évalué à 4.
En comparaison la documentation de OCaml est beaucoup plus simple. Elle est écrite de façon assez "matheuse" mais à un niveau beaucoup plus élémentaire: le côté matheux de la documentation est plutôt utilisé pour décrire brièvement une fonction par une phrase générale qui inclut aussi les cas particuliers (de type liste vide, etc.). Après pour l'exemple que tu cites, je ne sais pas ce qui pousse les gens à écrire des documentations comme ça... je ne dis pas que les phrases "Formally, the class Bifunctor represents a bifunctor from Hask -> Hask. Intuitively it is a bifunctor where both the first and second arguments are covariant." ne sont pas intéressantes mais elles sont plutôt à mettre en remarque, ou en tout cas, après la description de ce que "font" concrètement les fonctions du module.