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
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
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.
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
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 :
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
il faut éviter de multiplier les sources d’information car cela rend les choses plus difficiles à maintenir à jour
nous n’avons pas les ressources humaines ni une méthodologie adaptée pour la gestion de contenu multilingue évolutif
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
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 :
garder la documentation technique dans le dépôt duniter uniquement en anglais (y compris compilation manuelle par exemple)
utiliser le wiki uniquement comme page de garde pour rediriger vers les ressources adéquates (doc développeur, site duniter en/fr)
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)
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 , ç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.
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.
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.
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 :
grand public, qui ne connaît rien à la monnaie libre, la ǧ1, la trm, la blockchain, duniter
public avec de vagues notions mais qui souhaite se renseigner un peu plus
membre de la ğ1 ou futur membre qui souhaite approfondir sa connaissance du sujet
utilisateur avancé qui cherche des informations pour maintenir son nœud duniter
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.
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.
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.
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.
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 ?