Outils pour utilisateurs

Outils du site


fr:rapports:2021:01-16

2021/01/16 (wiki)

Présences :

  • HgO
  • tierce
  • Célo
  • Valhibou
  • Tharyrok

Mumble : https://mumble.src.brussels BBB : https://bbb.faimaison.net/b/hgo-hl7-r6u-bzc

Météo

Moment informel durant lequel on exprime en peu de mots comment on se sent et si on a une attente forte pour la réunion. Ce n'est pas un moment de discussion mais d'expression individuelle et ce n'est pas obligatoire 🙂

Attente(s) forte(s)

Si l'une ou l'autre personne exprime une attente forte, merci de vous en occuper en priorité ou de la noter dans le hub ou dans un point approprié.

Ordre du jour

Probablement parti sur une réunion en 2 temps. Faire le tour du wiki actuel … et une seconde partie sur BBB pour présenter Discourse.

Partie 1 : Wiki

Tour de table

pour exprimer le ressenti actuel à propos du wiki

L'origine de la réunion étant la mise en ligne de prise de notes à propos de différentes réunions.

Le wiki pas toujours abordable si on ne « connaît » pas la base.

Besoin éventuel d'avoir du matériel pour des formations.

Une des dificulter c'est de conserver les historique, mediawiki → wikijs → dokuwiki. L'ancien media wiki est disponible vers wiki-old.neutrinet.be.

Multilinguisme

Le coté multilingue est complexe, il y a eu un basculement de l'anglissisme de neutrinet vers le francisime due au membre actif de Neutrinet. Le fait d'ecrire en FR n'est pas inclusif pour les autre région de la Belgique.

Le dokuwiki prend en compte ce multilinguisme. Garder a jours dans les differante langue n'est pas garentit, ce qui fait une differance entre les differante langue. Il y a un invertisement quand la page FR est la base et qu'il y a une traduction en EN, un warning sur la version FR est afficher car elle est moin a jour que la version EN.

Dans dokuwiki on definit une langue de base (dans notre cas FR), ce qui ce trouve dans l'url sera en FR peut importe la langue lue. (ex : /commander/{nl,en})

https://wiki.neutrinet.be/vpn/vpn-order ne semble pas marcher pourtant.

C'est pas cool pour les gentils bot d'indexation et donc plus dificile de rendre visible le wiki sur les moteurs de recherche.

Un des logicelle qui montre une belle exemple c'est Grav (que l'on utilise pour le site web neutrinet.be) parce qu'il va retomber sur une page par défaut (la version originale) quand la traduction n'existe pas.

Pour discourse nous n'avons pas encore vu la gestion du multilinguisme. Une révérance c'est celle de nubo (agora.nubo.coop) car ils ont du géré les 3 langue (FR, NL, DE?) Plugin multilingual pour Discourse (semble encore actif) : https://meta.discourse.org/t/multilingual-plugin/142740

Une des questions c'est la gestion multilingue dans Neutrinet.

Un autre soucis étant que toutes les pages ne sont pas traduites et ça pose parfois problème quand on fait des liens inter pages.

Il y a un intéret de l'avoir dans plusieurs langues mais avec la limite des resources

Pour l'historique, le WikiJS n'était pas très pratique en terme de navigation, mais la version V2 (qu'on a pas testé) semble avoir fait de grosse améliorations.

Une section utile est la section PVS parce qu'elle est pas trop mal faite et qu'il y a le(s) template(s). Les pages « qui reprennent automatiquement d'autres pages c'est pratique » mais parfois rajouter des éléments ça « complexifie » le contenu.

Difficile aussi de suivre les pourquoi des pages ou des namespaces sont supprimés ou déplacés.

Comment structurer le wiki ?

Qu'est-ce qui nous semble « principal / crucial » comme contenu.

Quid de la documentation sur infra ou les applications notamment parce qu'on ne sait pas faire la part des choses entre le Gitlab et le Wiki. Vu la facilité de documenter dans gitlab (la page readme.md, ou la section wiki dans un repos) il est tentant de documenter là où se trouve le code.

Le Wiki est sans doute plus accessible pour l'utilisateur·ice qui n'est pas habitué·e au repo git.

En tout cas … éviter la redondance !! Parce qu'elle demande de faire 2 x le travail.

Avoir un point central pour la documentation permet aussi de rendre visible certains projets#. Cela permet aussi d'inviter les personnes moins technique de lire la documentation technique.

Par exemple une page comme celle-ci … est très techniques et on sait pas trop à quoi elle s'applique. Dés lors, ce genre de choses « wikifiées » pour des utilisateur·ice·s … n'est pas très utile ou pertinent.

Aux origines, c'est le besoin de laisser des traces qui ont amené les différentes personnes de Neutrinet depuis 2015 à mettre en place du Wiki.

Comme pour Wikipédia … c'est pourtant possible de participer au contenu … mais c'est pas pour autant qu'il y a des participations. Certes il y en a quelques-une mais c'est assez marginal.

Question … corriger des fautes d'ortografe ? Est-ce qu'on prendrait mal les corrections de fôtes paskue cé 1 vizion hélitistpe.

Si c'est Tharyrok qui ecrit tu peux même `rm -rf --no-preserve-root tharyrok` et réecrire :)

Accessibilité ?

  • Entre les technicien·e·s et les utilisateur·ice·s.
  • Pour les personnes mal-voyantes.

Séparation en Hubs

Est-ce que cela nous convient toujours ?

Ex : le hub infra et le hub cube on le renouvelllement des certificatr est dans le hub cube par exemple : le script pour le VPN, est pour la brique mais convient pour autre chose. Donc Hub brique ou VPN ?

hub-admin

Pas de « distinction » entre le légal, la compta, etc.

hubs-dc,infra,cube,vpn ?

C'est des trucs qui se mélangent parce qu'ils sont inter-dépendants.

Tutos / formations

  • Mais on a aussi un blog qui pourrait servir à ça ! Mais ça rajoute une couche à la multiplication des outils / site / …

Un tutoriel est fortement lié à un logiciel et à une version spécifique de ce logiciel. Quand une nouvelle version majeure arrive, il faut mettre à jour ce tutoriel, mais parfois aussi garder le tutoriel pour la version précédente.

Une totorielle demande une maintenance pour la garder à jours

trois techniques

  • énoncer les prérequis (fonctionne pour Debian 9 stretch, …)
  • afficher un warning « pourrait ne plus-être à jours »
  • corriger / adapter au fil du temps / des versions

Pas d'endroit « vie de l'assos »

Vie de l'assos ou gouvernances?

Mis à part les PVS/Rapports de réunions, il n'y a pas d'endroit où l'on indique comment en fait ensemble.

Partie 2 : Discourse

Petite Démo

Dans Discourse, le Wiki est un élément parmi d'autres. On peut transformer un message en Wiki. Ca permet alors d'avoir un historique.

L'element fondamental c'est un fil de discussion. On sait deplacer un ensemble de sujets vers une nouvelle categorie. Il faut minimiser le nombre de catégories pour éviter de ne pas savoir dans quelle categorie ça appartient. On peut utiliser les tags, qui sont généralement sous-utilisés, à la place.

Dans le menu du haut, on ce retrouve dans l'url /tag/vpn, qui liste les posts avec le tag vpn. Actuellement il y a un topic “Commender un VPN” qui est un topic wiki donc il liste l'historique des modifications. Ce topic a 2 tag (vpn, tutoriel). Comme tout topic dans discourse il y a sont fils de discution en dessous du premier post.

La structure n'est pas figé, on sais l'adapter en fonction de nos besoin.

Possibilité d'accès par mail, ordinateur, téléphone. Possibilité de faire un wiki mais aussi éventuellement l'utiliser pour faire un mailing, envoyer des infos à plusieurs personnes.

La page d'acceuil dans l'idée d'en faire un workflow, l'endroit oû l'on voit apparaitre la vie de l'association. Quelqu'un qui ne serait pas membre du groupe staff ne verait pas certaines catégories. Ces carrés changent en fonction de l'activité dans la categorie.

Une catégorie dans discourse permet d'attribuer des droits, beaucoup (trop) d'options, on peux aussi associer un mail à cette categorie. On peut aussi avoir un modèle. Il y a aussi la possibilité d'associer des tags à une catégorie. Car dans discourse il est préférable d'associer des tag à un topic et avoir un minimum de catégrie.

La création des categories est possible pour les admin ou les staff.

Il faut faire attenton car beaucoup d'actions ne sont pas visibles tant qu'on a pas cliqué sur certains boutons.

Il faut viser l'ouverture car actuellement nous ne sommes pas assez nombreux pour limité la visibilité.

Discource genere beaucoup de statistique, car il utiliser la gemification pour permtre au utilisateur actif d'augmenter leur trust level. Ce trust level donne plus ou moins de droit. Par exemple quand on s'inscrit sur discourse on commence au trust level 0, au plus on participe au plus on augmente sont trust level. Avoir un trust level permet de donnée acces a la moderation, par exemple modifier un titre de post.

Les moderateurs-trices on la possiblité d'ecrir des messages dans un fils de discution qui ne seront pas visible par les autre utilisateur qui ne sont pas moerataur ou admin.

Le menu afficher en haut de meta.neutrinet.be n'est pas présent par default. C'est un componnent dans la section themes de l'admin. Cela permet d'avoir des shortcuts vers certain

Retours

Intéressant … donne envie de casser le wiki et de passer là-dessus … Qu'est-ce qu'on voudra migrer ? Comment passer du wiki au discourse sans laisser les deux en parallèle pendant 1 an ?

Encore beaucoup de questions … s'attendait plus à une discussion sur le choix des catégories / la gouvernance au lieu d'une démo. Comment on fait pour ne pas noyer d'information dés la première page si on fait du discourse « la vitrine ».

Ça pourrait être OK pour remplacer « tout » les outils mais pas pour remplacer le site web (+1+1+1). La discussion sur les catégories est très fortement associée à la « manière » de penser de chacun·e.

En complémentarité, il serait bon d'alléger le site mais de faire le lien et déplacer du contenu de la « vitrine » vers le discourse.

Si on décide de migrer le wiki, HgO aimerait le faire petit à petit. À discuter lors de la prochaine réunion sur ce sujet.

Lister les outils que le discourse pourrait remplacer … et voir si c'est remplaçable par lui.

Prochaine réunion

Prochaine réunion : 06/03/2021 à 14:00

Lieu : Mumble + Caldarium

À faire

  • Tharyrok regarde si les fonctionnalités de Zammad sont bien repris dans Discourse
  • Lister les fonctionnalités de Discourse (de manière générale: documentation, ticketing, etc.)
  • Migration du wiki : quoi, pourquoi, comment
  • Workflow des décisions / des choses à faire

Questions

  • Une des questions c'est la gestion multilingue dans Neutrinet ?

Météo de fin

Moment informel durant lequel on exprime en peu de mots comment, à titre personnel, la réunion a été vécue que ce soit positif ou négatif. Si une ou plusieurs tension est née durant la réunion, il est peut-être nécessaire d'envisager l'une ou l'autre réunion pour y remédier.

fr/rapports/2021/01-16.txt · Dernière modification: 2022/01/30 01:42 (modification externe)