Produits Entr'ouvert » Authentic 2

Ping ?

Ping ?

Loïc Dachary a écrit :

J'ai aussi corrigé des erreurs triviales

Merci, on est tout à fait preneurs.

Par contre je ne comprends pas le cœur du ticket, le cycle de mise à jour Publik correspond à la production de paquets .deb dans nos dépôts debian, qu'est-ce que cela a avoir avec l'installation d'authentic via pip dont parle le fichier ?

qu'est-ce que cela a avoir avec l'installation d'authentic via pip dont parle le fichier ?

Comme écrit dans le commentaire https://dev.entrouvert.org/issues/51668#note-2 c'est un nettoyage.

Toujours pas compris, je veux bien que tu reformules (et je pense que ton lien est faux, il pointe sur « ajout de la licence MIT »).

Il n'y avait pas de confusion, ma remarque portait vraiment sur cette unique ligne.

Je pense que l'information apportée n'est pas compréhensible dans le contexte du fichier, elle ne le devient que quand on a lu le mail pointé dans la description du ticket, en fait il s'agit de savoir quand sont publiés des paquets Debian par Entr'ouvert, mais rien n'indique ça ni dans le patch ni dans la page wiki qui parle des mises à jour de notre SaaS.

Donc soit largement contextualiser l'info pour la rendre intelligible, soit se dire que la manière dont EO fait des paquets ne concerne pas le logiciel authentic.

Donc soit largement contextualiser l'info pour la rendre intelligible, ...

Tu touches la un problème de fond, en effet. La documentation d'Authentic est, dans l'état, assez peu intelligible de façon générale. Elle est aussi parfaitement inutile aux personnes d'Entr'Ouvert, comme en témoigne l'absence de modifications ces deux dernières années.

Elle est cependant utile comme mémo pour des personnes qui y laissent des petits morceaux de pain pour ne pas se perdre dans la forêt. Cette information sur le cycle de release d'Authentic m'est utile (car je vais l'oublier) et elle sera utile à d'autres personnes extérieures à Entr'Ouvert, je pense. Elle pourrait bien sur être améliorée comme tu le suggère, mais étant donné l'état d'abandon de la documentation en général, apporter un très grand soin à cette modification particulière n'est peut-être pas nécessaire.

Je t'invite donc à prendre mes correctifs de documentation (celui ci et d'autres à venir) dans cet esprit. Est-ce que cela te convient ?

D'accord mais

Loïc Dachary a écrit :

elle sera utile à d'autres personnes extérieures à Entr'Ouvert

C'est important et dans ce cas là tel que c'est écrit, j'en doute.

Pour rendre l'affaire compréhensible à un œil extérieur j'imagine qu'il suffirait de dire « alternativement à l'installation depuis les sources, EO maintient des paquets Debian <lien vers le dépôt> qui sont mis à jour suivant le cycle décrit ici <lien vers le wiki> ».

Entr'ouvert (pas de majuscule au O).