Le 07/02/2022 à 07:15, David Durieux a écrit : …
il n'y a pas de documentation, t'es juste obligé de faire du rétro ingeniering sur des fichiers docker pour pouvoir installer une bête appli web.
La documentation est effectivement la grande oubliée actuellement.
Il n'y a même plus de livre de référence à jour sur quoique ce soit et on en est réduit à errer sur Internet en cherchant l'information valable dans le foin des logorrhées inutiles.
Et ni la liste des fichiers sources ni les commentaires pertinents qu'ils contiennent parfois ne remplacent une vrai documentation qui doit décrire, en langage courant (français, anglais, …), le service attendu du point de vu de l'utilisateur (et il y a plus de 1001 façons de concrétiser une telle description en traitements, souvent plus de 1000 mauvaises et une seule bonne).
Pourtant, rédiger une vrai documentation est une excellente opportunité de débusquer les bugs résiduels.
Pour revenir au domaine de cette liste, il y a une documentation que je rêverais de trouver : la signification des messages abscons que l'on découvre dans les logs. Où pourrait-on la trouver ?