Maintenance du site web de Duniter

Et même si tu ne souhaite pas être mainteneur @anon88550267, je pense que c’est une bonne idée que tu est les droit pour merger tout seul quand tu sais que c’est un petit changement et que tu est sûr de toi.

je sais que tu vérifiera derrière si le site fonctionne toujours bien, et si quelque chose est cassé il est toujours possible de revert le merge depuis le gitlab afin de rétablir le site :slight_smile:

1 Like

Une publication automatique, mais plutôt sur un site de test, me paraît une bonne idée. Puis vers le site de production depuis une autre branche.

Ok, j’accepte les privilèges Maintainer.

Je ne suis pas convaincu que je vais pouvoir/vouloir continuer à m’intéresser à la ML sur le long terme, mais si je peux merger les quelques contributions pour lesquelles il me reste un peu de motivation c’est cool :slight_smile:

2 Likes

J’avais eu le même problème à l’époque où j’avais fait la version multilingue du site, et du coup, ça n’avait jamais abouti. Je ne me sens pas la force de contribuer sur quoi que ce soit en ce moment et jusqu’à ma thèse se finisse (par soutenance ou par abandon), par contre, je veux bien participer à la relecture des contributions sur les trucs pas trop technique comme les site web. Il faut juste que je trouve comment me mettre dans la boucle pour ne pas louper les MR et que j’ai les permissions.

2 Likes

Petite note pour le futur : il faudrait repenser la manière dont on communique en anglais. Je pense qu’on peut arrêter le site web duniter anglais (https://duniter.org/en/) et créer un wiki en anglais digne de ce nom pour duniter (https://git.duniter.org/nodes/typescript/duniter/-/wikis/). Ce wiki servira de « ground truth » pour tout site qui voudra donner des informations techniques comme le site duniter.org par exemple.

Dit autrement, la responsabilité de l’équipe de développeurs est de maintenir le wiki duniter. Maintenir le site duniter francophone (ou n’importe quel autre site qui voudrait présenter duniter dans une autre langue) relève d’une autre responsabilité.

Je veux bien me coller à cette tâche plus tard si vous êtes d’accord avec cette manière de faire.

Note à moi même (TODO) :

  • reprendre ce qu’il y a de bien dans le wiki actuel
  • reprendre ce qu’il y a de bien dans le site duniter en anglais
  • annoncer sur le site duniter francophone que les informations techniques les plus à jour sont disponible en anglais sur le wiki duniter
3 Likes

Ok, donc j’aimerais savoir qui sont en ce moment les interlocuteurs privilégiés pour

S’il n’y en a pas, je veux bien le devenir.

Je note mes pensées ici au fur et à mesure pour en garder une trace et réorganiser.

  • @elois a déjà beaucoup de boulot avec duniter et préfère écrire la documentation technique dans le même dépôt : https://git.duniter.org/nodes/typescript/duniter/-/tree/dev/doc
  • l’ancien wiki contenait en multilingue en/fr
    • un dictionnaire du vocabulaire du projet duniter (identity/membership/node)…
    • une sorte de FAQ
    • une ébauche d’explication de l’architecture
    • un guide pour rejoindre la communauté
  • la documentation présente dans /doc comporte
    • liens vers la RFC
    • description de l’API HTTP (BMA)
    • instructions de compilation manuelle et d’install docker
    • un guide basique des commandes en CLI
    • doc développeur comme
      • installation de l’environnement de développement
      • conventions git du projet
      • architecture des dossiers
  • le site duniter français contient
    • les bases de la monnaie libre
    • les bases de la ğ1
    • la base de la wot
    • une page annuaire « contribuer » qui lie vers les logiciels et des tas de liens
    • une page « forger des blocs » qui contient ce qu’était le wiki précédent mais pas à jour
    • un fil d’actualités qu’on ne met pas à jour
  • le site duniter anglais contient
    • les mêmes pages de wiki plus tout à fait à jour
    • l’ancien design du site

Je pense les choses suivantes :

  1. il est important de conserver des informations à jour pour ce qui touche à l’installation de duniter et à la documentation développeur. des informations dépassées nuisent à la compréhension et à l’adoption du projet
  2. il faut éviter de multiplier les sources d’information car cela rend les choses plus difficiles à maintenir à jour
  3. nous n’avons pas les ressources humaines ni une méthodologie adaptée pour la gestion de contenu multilingue évolutif
  4. la fonctionnalité « wiki » de GitLab ne permet pas de gérer le dépôt comme un dépôt normal, cad contributions, fork… il faut donc éviter d’avoir à y apporter trop de modifications
  5. il est important d’être clair sur la distinction monnaie libre / duniter / monnaie ğ1 / écosystème logiciel pour la ğ1

C’est pourquoi je propose ce qui suit :

  1. garder la documentation technique dans le dépôt duniter uniquement en anglais (y compris compilation manuelle par exemple)
  2. utiliser le wiki uniquement comme page de garde pour rediriger vers les ressources adéquates (doc développeur, site duniter en/fr)
  3. retirer tout ce qui est susceptible d’être modifié par la suite de la version anglaise du site duniter (actualités, informations liées à une version particulière du logiciel). viser une fréquence de mise à jour de ce site de 1/an maximum (j’ai les droits sur le dépôt, je vais le faire si vous êtes d’accord)
  4. mettre à jour le site duniter francophone et avoir une personne en charge de le mettre à jour dès qu’une modification est nécessaire (information importante à mettre dans les actualités, modification des instructions). je me propose pour cette tâche, j’ai déjà les droits sur le dépôt, je vais le faire dans la semaine prochaine unilatéralement à moins que quelqu’un ne s’y oppose ici.

Voilà, désolé de mettre tout ce que je pense, mais si vous n’avez pas envie de lire et que vous me faîtes confiance, laissez un :+1:, ça me permet d’avoir une forme d’approbation. @elois j’ai besoin des droits sur le dépôt duniter pour éditer la doc et le wiki, @cgeek, @anon88550267, @moul, @galuel, @kimamila , n’hésitez pas à vous exprimer aussi.

3 Likes

Je ne sais pas ce que tu nommes “le wiki de duniter”, ou alors tu parles de celui sur le site web, mais du coup bah c’est le site web.

Nous n’avons plus de référent sur les sites web aujourd’hui, @Moul gère ça par défaut.

Il faut surtout ne pas l’utiliser. Comme dit précédemment, on ne s’en servait que comme page de release, maintenant ça n’a plus de sens de s’en servir. Et comme tu le dis toi-même, il ne faut pas démultiplier les supports, donc je pense qu’il faut oublier la fonctionnalité wiki du gitlab,on n’en a pas besoin.

Pourquoi “uniquement en anglais” ? Non la documentation technique directement dans le dépôt je la rédige aussi en français, car je suis plus précis dans cette langue et que la plupart des contributeurs son francophone.

Pour la doc pas besoin, tu peux faire une MR. Et pour le “wiki” il n’y en a jamais eu sur le gitlab, je ne vois pas pourquoi on en créera un alors qu’on parle justement de ne pas s’éparpiller.

Je préfère le fonctionnement suivant :

  • Je maintiens la doc technique dans le dépôt.
  • On doit trouver quelqu’un pour maintenir le contenu des sites web.
1 Like

C’est d’ailleurs ce que tu devrait faire même si tu avait les droits sur le dépôt. Il ne faut jamais commiter directement sur la branche dev, il faut toujours faire une MR, y compris pour la doc.

1 Like

Permettez-moi de râler un peu en public, ça défoule. Ça m’énerve d’arriver sur un site qui a subi tellement de modifications qu’il est impossible à maintenir. La doc est dégueu et les dépendances moches. Il y a de la duplication de code et l’outil pélican a été mal utilisé. Je vais avoir encore une fois pas mal de boulot. Je pense de plus en plus sérieusement à remettre ça à plat en reprenant de zéro.

@elois, oui, je vois que tu as supprimé le wiki Gitlab de duniter. Je pensais mettre une page de garde pour rediriger, mais ça va aussi si on ne met rien. C’est sur ce dépôt que je voulais les droits pour force push les modifications. J’ai commencé un fork de la doc de duniter qu’on peut voir ici : doc · dev · Hugo Trentesaux / duniter · GitLab je ferai une MR quand je serai prêt.

Je vais le faire, c’est pour ça que je me dis que remettre à plat peut m’économiser des efforts par la suite.

Bon, après pas mal de temps à observer le site, je l’ai trouvé dans un état encore pire que quand j’avais fait le travail pour fusionner le site anglais et français. Je ne suis donc prêt à le maintenir que si je le reprends de zéro (tout en récupérant les contenus et designs). Si je fais ça il se pose quelques questions.

Le site est devenu un sorte de mélange entre

  • le site du logiciel duniter
  • un site sur la monnaie libre
  • un site sur la TRM
  • un site annuaire sur l’écosystème de la ğ1

Je pense que c’est trop d’ambition pour un site maintenu par une ou zéro personne. Il est donc temps de rassembler un peu les efforts qui ont été dispersés dans :

Plutôt que chaque site cherche à re-expliquer les concepts expliqués à d’autres endroits.

Je continue mon petit brainstorming tout seul.

publics visés

  1. grand public, qui ne connaît rien à la monnaie libre, la ǧ1, la trm, la blockchain, duniter
  2. public avec de vagues notions mais qui souhaite se renseigner un peu plus
  3. membre de la ğ1 ou futur membre qui souhaite approfondir sa connaissance du sujet
  4. utilisateur avancé qui cherche des informations pour maintenir son nœud duniter
  5. développeurs ou profils techniques qui cherchent à obtenir des informations précises

Chaque tranche de public est prête à investir un peu plus d’effort dans ses recherches, mais il faut que chacun sache où trouver les informations dont il a besoin.

Pour l’instant, aucun site n’identifie clairement son public, la base est du grand public, et c’est pour ça qu’on se retrouve avec la même information à quinze endroits différents mais mal dite.

Pour moi, le site duniter.org ne doit s’adresser qu’aux profils 3 et plus. Les profils 2 et moins devront plutôt être orientés vers monnaie-libre.fr. Partant de là, on peut complètement ré-organiser les deux sites pour sortir de cette bouillie vaseuse.

thèmes

  • la ğ1, une monnaie éthique fondée sur la confiance
  • la monnaie libre, une théorie monétaire relativiste, un référentiel de valeur
  • duniter, un logiciel qui fait fonctionner la monnaie libre ğ1
  • l’écosystème logiciel autour de duniter (wotwizard…)
  • les logiciels pour l’utilisateur de la ǧ1 (clients, places de marché)
  • la communauté de la ǧ1 (forums, sites locaux, discussions)

Tout site qui essaye de viser tous les publics et d’aborder tous les thèmes nécessite un travail monstrueux, largement hors de portée d’une personne unique. Donc soit on veut le faire quand même et on arrive à réunir cinq personnes sur le même projet et dans la durée pour avoir un ensemble cohérent, soit on découpe.

Là, je suis plutôt parti pour découper. Les sites des groupes locaux ont déjà fait un énorme travail de vulgarisation et je pense qu’ils couvrent assez bien le public 1 et réoriente correctement le public 2 vers les sources existante. Notre responsabilité est donc de faire un site pour les publics 3 et 4, ce qui est plus facile.

5 Likes

Totalement d’accord avec ça. Perso je ne redirige jamais un humain lambda vers duniter.org, mais je dirige les gens vers monnaie-libre.fr, qui redirige déjà les visiteurs en quête d’informations plus techniques vers duniter.org.

1 Like

De même, un utilisateur qui cherche plus d’informations sera gêné par le nouveau look du site duniter.org qui rend plus difficile de trouver les informations. Je ne m’étais pas rendu compte de ça.

En quoi le nouveau look rend-il les informations plus difficiles à trouver ? Je le trouve bien moi ce nouveau look.

Un truc urgent est de mettre à jour toutes les commandes duniter sync erronées avec le 443 qui induit tout le monde en erreur.

Je m’apprêtais à le faire quand j’ai vu une MR datant d’un an à ce sujet.

3 Likes

Juste une précision sur infojune : le site n’explique rien du tout, il ne fait que donner des liens.

1 Like

Je crois que les sites pour les techos devrais commencer par un avertissement :
“Ce site s’adresse aux techniciens, pour découvrir la monnaie libre et son univers rendez-vous sur monnaie-libre.fr

Je trouve cela dommage, une phrase explicative pour chaque lien, éviterai d’avoir à cliquer pour savoir de quoi ça cause.

1 Like

Bof, t’as vu le nombre de liens ? Si on devait raconter l’histoire de chacun, le site ne tiendrait pas sur une page et ce serait carrément indigeste. En plus, il y en a déjà plein qui font ça, et finalement ça fait trop d’infos pour la bleusaille, ça fait peur. Non, le but était simplement de retrouver un outil facilement pour ceux qui le recherchent, pas d’expliquer la june, c’est juste un site d’indexation en fait. Et c’est bien qu’il y en ait un, non ?

Pour la première fois depuis un moment, je prends le temps de lire la (longue) page d’accueil de monnaie-libre.fr et je trouve ça d’une qualité moyenne. C’est bien en tant qu’article ou « page de FAQ », mais ce n’est pas à la hauteur d’un « site officiel ». Est-ce qu’on a l’historique des modifications ? Quoi qu’il en soit, ça vaut le coup de réorganiser la vaste quantité de contenu à notre disposition. J’avance doucement, il y a pas mal de travail.

Je crois que le site monnaie-libre.fr est géré et hébergé par axiom, mais je ne suis pas sûr, @poka tu peux nous en dire plus ? Y a-t-il un dépôt git pour le site monnaie-libre.fr ?