Ce qui est complètement crétin, évidemment, c'est de ne pas documenter son code.
Ca, ca reste a prouver. Je préfère typiquement du code type en python par exemple a des docstrings avec la liste des parametres qui ne seront pas a jour un jour ou l'autre.
Il vaut bien mieux faire des revues de code, simplifier autant que possible le code, les noms de variables, la logique, adopter les meilleures conventions de codage (les trucs genre SOLID ou quoi), écrire des tests (unitaires ou fonctionnels), avoir une approche devops de l'infrastructure pour que chacun soit autonome pour lancer l'app ou les tests.
Mais écrire de la doc quand tu as les pratiques de développement standard, bof franchement, la valeur ajoutée est presque nulle. De toute facon, personne ne la lit parce que c'est fatigant et elle n'est pas a jour.
[^] # Re: Complètement crétin !
Posté par flagos . En réponse au journal Comment briller auprès de la gent féminine dans « le monde de la tech ». Évalué à 4.
Ca, ca reste a prouver. Je préfère typiquement du code type en python par exemple a des docstrings avec la liste des parametres qui ne seront pas a jour un jour ou l'autre.
Il vaut bien mieux faire des revues de code, simplifier autant que possible le code, les noms de variables, la logique, adopter les meilleures conventions de codage (les trucs genre SOLID ou quoi), écrire des tests (unitaires ou fonctionnels), avoir une approche devops de l'infrastructure pour que chacun soit autonome pour lancer l'app ou les tests.
Mais écrire de la doc quand tu as les pratiques de développement standard, bof franchement, la valeur ajoutée est presque nulle. De toute facon, personne ne la lit parce que c'est fatigant et elle n'est pas a jour.