Non, la documentation, c'est chiant, ça ne sert à rien si tu peux aller dans le code directement.
C'est un peu plus dur en bouche que la documentation, mais on défend vraiment le babybel face à un bon vieux maroilles ici ?
Alors que l'ananas sur la pizza, c'est le petit plus qui est corolaire au noyau, mais pas directement à l'intérieur du fruit.
Posté par steph1978 .
Évalué à 3 (+1/-0).
Dernière modification le 18 juin 2025 à 20:52.
Le code dit comment c'est fait.
La doc dit à quoi ça sert et comment l'utiliser
Une bonne doc c'est extrêmement plaisant à utiliser.
Des exemples qui me viennent : jq, sqlpage, jinja, python stdlib.
Une mauvaise doc c'est une doc qui se contente d'énumérer la liste des fonctions avec une description qui paraphrase le nom de la fonction.
J'ai trouvé un peu de ça dans les packages elixir ou python alors que j'adore programmer dans ces langages.
# non, c'est l'inverse
Posté par steph1978 . Évalué à 4 (+2/-0).
La documentation c'est pénible à faire et agréable à consommer.
L'ananas sur la pizza, c'est facile à faire et désagréable à consommer.
[^] # Re: non, c'est l'inverse
Posté par uso (site web personnel) . Évalué à 1 (+0/-0).
Non, la documentation, c'est chiant, ça ne sert à rien si tu peux aller dans le code directement.
C'est un peu plus dur en bouche que la documentation, mais on défend vraiment le babybel face à un bon vieux maroilles ici ?
Alors que l'ananas sur la pizza, c'est le petit plus qui est corolaire au noyau, mais pas directement à l'intérieur du fruit.
[^] # Re: non, c'est l'inverse
Posté par steph1978 . Évalué à 3 (+1/-0). Dernière modification le 18 juin 2025 à 20:52.
Le code dit comment c'est fait.
La doc dit à quoi ça sert et comment l'utiliser
Une bonne doc c'est extrêmement plaisant à utiliser.
Des exemples qui me viennent : jq, sqlpage, jinja, python stdlib.
Une mauvaise doc c'est une doc qui se contente d'énumérer la liste des fonctions avec une description qui paraphrase le nom de la fonction.
J'ai trouvé un peu de ça dans les packages elixir ou python alors que j'adore programmer dans ces langages.
Envoyer un commentaire
Suivre le flux des commentaires
Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.