-
@martin1975 Si tu parles de javadoc ou équivalent, le problème reste le même. Pas de navigabilité/traçabilité. Tu penseras peut-être à changer la doc associée à la fonction que tu viens de modifier. Certainement pas l’ensemble des docs des fonctions qui appellent la tienne et […]On twitter.com
Mood 0
-
@martin1975 peuvent du coup possiblement inclure une référence devenue fausse suite à ta modification.Permalink On twitter.com
Mood 0
-
@martin1975 Exemple sur mon code : si tu détailles dans la doc de la fonction Fight::fight() le détail de l’algo de résolution du combat, ben changer une des formules de calcul dans une classe située à environ 20 parsecs de la-dite fonction change sa documentation…Permalink On twitter.com
Mood -3 🙁
-
@martin1975 Je doute que quelqu’un qui modifiera FightFormula.getShieldDeflection appelée par Units.shoot appelée par Fight.fight pensera à aller vérifier si la doc Fight.fight n’en parlait pas…Permalink On twitter.com
Mood -5 🙁
-
@martin1975 Et donc je ne dois pas parler de ce détail d’implémentation dans la doc de Fight.fight. Ni même de la fonction de déflection des boucliers. Parce que si je la vire et que je la remplace par autre chose… Ben doc obsolète de Fight.fight…Permalink On twitter.com
Mood -3 🙁
-
@martin1975 (Alors que je n’ai touché qu’à Units.shoot, situé à 3 niveaux de profondeur d’appel par rapport à Fight.fight)Permalink On twitter.com
Mood -3 🙁
-
@martin1975 Et du coup, soit je me résume à « Fight.fight : Attention, ça va fighter !!! » pour la doc, et du coup elle devrait rester relativement up-to-date assez longtemps, soit je rend la maintenance de la doc juste apocalyptique…Permalink On twitter.com
Mood -1 🙁
-
@martin1975 Ou ne serait-ce que des gags comme ça 😂 bugs.python.org/file31338/fix_documentation_on_rand_egd_function.patchPermalink On twitter.com
Mood +1 🙂