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 ?
_______________________________________________
Liste de diffusion du %(real_name)s
http://www.frsag.org/
