YunoHost project organization
Find a file
2016-11-08 11:01:55 +01:00
organization_schema.jpg [enh] remove meeting details, add image in repo. 2016-11-02 11:33:56 +01:00
README.md [enh] add readme as a symbolic link toward the document. 2016-11-08 11:01:55 +01:00
yunohost_project_organization_fr.md Merge pull request #4 from maniackcrudelis/patch-4 2016-11-08 10:54:29 +01:00

Organisation du projet YunoHost

Objectif du document

Ce document a pour objectif de permettre aux contributeurs de se sentir légitimes deffectuer une contribution dans le projet YunoHost avec un avis collectif. Le projet étant communautaire, les prises de décisions prises hâtivement par un groupe restreins de contributeurs peuvent entraîner des frustrations postérieures. Pour palier à ce problème, la solution proposée ici est de faire en sorte que les décisions soient prises collectivement et quelles soient suffisamment réfléchies. Un conseil oriente lévolution du projet YunoHost, et des groupes dintérêts permettent de contribuer plus efficacement en fonction des domaines de prédilection de chacun.

Définition de YunoHost

Objectifs

Selon le site web : « Le but de YunoHost est de rendre accessibles au plus grand nombre linstallation et ladministration dun serveur, sans délaisser la qualité et la fiabilité du logiciel. »

Nous proposons de limiter YunoHost au simple logiciel et de ne traiter aucun service auxiliaire estampillé sous le même nom (support payant, dns, hébergement). La fourniture de services devrait être laissée à d'autres structures gravitant autour du logiciel, qu'elles soient des entreprises ou des associations. Cela afin de concentrer l'activité de Yunohost sur la qualité du logiciel. Ce postulat pose la question des services comme nohost.me, qui devra être débattue.

Valeurs

Un logiciel libre et communautaire Par rapport à d'autres initiatives, (InternetCube, Sandstorm, Freedombox, cozy, ArkOS, serveur NAS (synology), kodi) YunoHost se distingue en étant :

  • un logiciel sous licence libre
  • entièrement communautaire
  • reposant sur des applications libres existantes (roundcube, baikal, etc.)

Que chacun peut s'approprier Historiquement, le projet est très proche des initiatives visant à la création d'un internet neutre et décentralisé. Cette proximité, notamment avec la FFDN, a amené une partie des contributeurs de YunoHost à créer la Brique Internet dont la mission est de faciliter l'auto-hébergement en fournissant une solution complète incluant service (via un VPN) et matériel. Cet aspect militant n'entrave pas des initiatives commerciales du logiciel pour lequel des entreprises pourraient proposer du support ou de l'hébergement.

Organisation de YunoHost

Une structure ouverte, organisée par thèmes

L'objectif de l'organisation de YunoHost est de permettre au plus grand nombre de contribuer à l'amélioration du logiciel, que ce soit d'un point de vue technique (développement, packaging d'application) ou non (communication, assistance aux utilisateurs, documentation, etc.). Inspiré par différents projets passés en revue lors de l'événement (Kodi, Debian, Django, Fedora, Wikipédia, etc.) et des idées des contributeurs de YunoHost (Jérôme, Bram, opi, scith, ju), il a été décidé d'une organisation en groupes spécialisés, fédérés par un conseil de contributeurs clés.

Schéma dorganisation du projet YunoHost :

Schéma d’organisation du projet YunoHost

Définition et constitution des groupes

La constitution de groupes part du constat que YunoHost compte beaucoup de sous-projets (treize au total), mais que l'on sait pas toujours qui en est en charge ou qui y est compétent. Il est donc proposé une simplification de l'organisation des sous-projet en groupes thématiques :

  • Groupe Core Dev

  • Core YunoHost

  • Moulinette

  • Admin web

  • SSOwat

  • Dynette

  • YNH-Dev

  • Groupe Apps

  • Apps Officielles

  • Apps Communautaires

  • outils de développements d'app (package_checker, package linter)

  • Groupe Communication

  • Documentation

  • Communication (annonce évolutions du projet sur le forum, réseaux sociaux)

  • Traduction

  • Groupe Infra/Adminsys

  • Infrastructure

  • Site web (wiki, forum, salon de discussion, redmine, mumble)

  • Démo

  • Services

    • ip.yunohost.org
    • yunoport
    • nohost.me
    • yunodash
    • yunopaste
  • Groupe Support

  • Groupe distribution

    • Création et maintenance des images d'installation sur diverses architectures
    • Distribution des images
    • Gestion de la distribution des paquets Debian.

Les groupes sont ouverts à tous les contributeurs souhaitant participer au développement de YunoHost. Chacun peut s'inscrire aux canaux de communication associés aux groupes auxquels il souhaite prendre part. Chaque inscrit est libre d'échanger avec le reste du groupe, de voter et de proposer au vote une décision à la suite d'une étape d'échange et d'amélioration de la proposition. Afin de faciliter sa gestion, chaque groupe nomme donc un coordinateur (et un remplaçant) dont le rôle est :

  • d'accueillir et fédérer les nouveaux contributeurs réguliers de son groupe
  • de tenir informé le conseil des décisions prises au sein du groupe (cf. point suivant)

Le choix d'un outil de communication est laissé à chaque groupe en fonction de sa pertinence (forum, chat, ML, etc.).

Définition et constitution du Conseil

YunoHost grandissant, il est important de maintenir une cohérence entre tous les groupes, néanmoins il est impossible d'imposer à chacun des membres des groupes de s'intéresser ou de s'impliquer sur tous les aspects du projet (pour des raisons de temps et de compétence). Pour pallier à cela, il est proposé de créer un meta-groupe, où chaque groupe sera représenté par au moins un de ses membres : le Conseil. Le Conseil est indépendant des groupes et réuni les contributeurs souhaitant s'impliquer le plus dans le projet, son rôle est de :

  • prendre les décisions importantes sur YunoHost qui ne dépendent pas d'un seul groupe (par exemple changer le moteur du wiki)
  • faire des points réguliers sur l'ensemble du projet pour assurer sa cohésion. (réunion Mumble)
  • solliciter l'ensemble de la communauté des contributeurs (ou même des utilisateurs) quand une décision divise les groupes et/ou le conseil

Le choix d'un outil de communication est laissé au conseil, ses décisions doivent néanmoins être consultable par l'ensemble de la communauté de contributeur. Pour participer aux votes du conseil, il faut avoir contribué au projet et avoir obtenu un droit de vote (ou d'entrée) au sein du conseil. Ce droit est délivré par le conseil (éventuellement sur demande). Le conseil est libre à tout moment de modifier le processus de décision. Être membre du conseil n'implique pas forcément d'avoir l'ensemble des accès (infra, dépôt etc...).

Un processus de prises de décision basé sur un consensus mou

Les décisions à prendre peuvent être de deux ordres :

  1. pour un groupe (par "exemple merger une PR" serait affecté au groupe Dev tandis que "poster un tweet" serait de la responsabilité du groupe Communication)
  2. pour l'ensemble du projet (par exemple décider d'une release avec des nouvelles fonctionnalités)

Si un consensus sur une décision à prendre n'est pas trouvée au sein d'un groupe, ce dernier devra se tourner vers le conseil pour en débattre. Si aucun consensus n'est trouvé, la proposition sera soumise au vote de tous les contributeurs.

Le processus de prise de décision en détail

1) Initiation d'une décision à prendre
  • peut-être initiée par n'importe qui suivant les mediums définis au sein de chacun des groupes (exemple : ouvrir une PR déclenche automatiquement ce processus)
  • forcément publique à l'exception de situations bien définies (bug relatif à la sécurité critique ou vote sur les personnes)
  • une date de clôture est automatiquement définie par type de proposition. La définition de la date remplie plusieurs fonctions :
    • pouvoir laisser le temps à tout le monde de s'exprimer et ne pas prendre la décision trop vite
    • maintenir un rythme car si le quota des réponses est rempli avant le temps imparti, il n'y a pas besoin d'attendre l'avis de tout les membres du groupe
      • le quota est à évaluer en fonction des personnes inscrites au groupe (ou au conseil selon la situation) qui ont manifesté leurs souhaits d'être considéré comme votant régulier => exemple kload peut vouloir donner son avis ponctuellement, mais à priori il ne souhaitera pas être considéré comme membre votant actif du conseil
    • pouvoir être repoussable sur simple demande d'une des personnes du groupe. Et seulement du groupe, pas tous les contrib.
2) Ouverture de la discussion, plusieurs réponses possibles :

Tout le monde peut changer de positions à n'importe quel moment, mais il est de bon ton de laisser au groupe le temps de réagir si cela est nécessaire (pas passer de positif à négatif puis rejeter la proposition 3 min après par exemple.)

  • réponses dites "simple"
    • "je suis d'accord" -> vaut pour un avis positif
  • "ça me semble bon, mais je préfère m'en remettre aux autres" -> si jamais il n'y a que des avis comme cela (ou le suivant) et au moins un avis positif et que la date est passé, la proposition est acceptée
  • "pas d'avis" / "je ne suis pas en position de donner un avis pertinent (exemple: je sais pas coder en X)"
  • réponses délayantes/différées
  • demande de précisions, dans ce cas la décision est suspendue
  • refus
  • il y a deux types de refus
    • "cela doit être fait autrement"
    • "on ne doit pas faire ça"
  • tout refus doit être argumenté et justifié
3) Suspension/Repoussement
  • tant qu'il n'y a pas de réponse, la décision est suspendue, au moment de la réponse, la date de clôture est automatiquement repoussé (si besoin) (pour une durée, à définir, moins longue que la première fois)
  • situation où il y a des avis positifs et négatifs ou situation où il y a un choix à faire entre plusieurs propositions
4) Demande de modifications
  • mais il se peut qu'il y ai discussion autour de ces modifications, si c'est le cas, cela devient une nouvelle décision à adjoindre à la liste des décisions à prendre et le processus s'y applique alors (et cela repousse la date)
  • dans le cas contraire, un membre du groupe peut demander à ce que l'on fasse un vote qui portera sur la liste des possibilités qui font conflits + "ce vote est mal formulé, reformulons le"
  • s'il n'y a pas assez de monde d'accord, la date est repoussée et un rappel doit être envoyé
  • si le résultat est vraiment serré, le groupe est invité à rediscuter de la question si elle est importante, car cela pourrait être source de division et de tension à l'avenir
5) Clôture
  • si le groupe est unanime dans sa décision
  • que des avis positifs
  • que des refus
  • sans avis (s'en remet aux autres)
  • si le quota de réponse est atteint et que la date est atteinte
  • s'il n'est pas possible d'avoir assez de monde (vacances, plus assez de membres du groupe pouvant avoir un avis) il est possible pour le groupe de demander la clôture quand même, il y a alors un nouveau décalage de la date et si cette nouvelle date est franchie, la proposition est clôturée
    • si 1/3 arrondi au supérieur (exemple: 1/3 de 4 == "1.33.." -> 2) [à débattre pour ce %] des participant·e·s s'étant exprimé·e·s sur cette question sont favorables au vote, alors le vote est ouvert et prend fin lorsque tout le monde a répondu (ou si nécessaire, après une date de clôture)
  • pourcentage davis positifs différents suivant limportance de la prise de décisions : 50 %, 66 %, 80 %.
6) Application

Alors un membre du groupe peut annoncer la décision comme effective (et procéder aux actions nécessaires comme releaser, merger, annonce, autre ...). Il est important que s'il y a besoin de certaines actions, des personnes se soient engagées à les faire, une décision sans désigner est moyennement utile

Plan daction

Différentes idées ont été relevées au cours de la réunion par les personnes présentes. Les décisions du week-end devraient être publiée sur le forum (ou autre) pour être détaillées et discutées, en vue d'être acceptées.

Plan de migration

Il est proposé d'appliquer dés à présent ce processus décisionnel, toutefois vu que ce n'est qu'un brouillon, chaque personne est invitée à publier des propositions de modifications/améliorations/précisions et à les soumettre. Les décisions se prendront sur le forum étant donné que Maniack et Moul ont des problèmes techniques de réception ou d'écriture sur la liste de discussion mail. Rappel il est possible de s'abonner par mail au forum, par contre la fonctionnalité de réponse par mail semble ne pas fonctionner.

Mise en place dun système de vote via Discourse plus intéressant que par mailling list.

Conseil : Bram, ju, ljf, Maniack C, Moul, opi, (scith, tostak, theodore) (à élire ? auto-promotion par méritocratie ? renouvellement au lieu de demander un retrait par dautres membres (processus négatif))

  • Representants des groupes dintérêts (élus ou auto-proclamés) :
    • Dev : opi, Bram, ju, ljf
  • Apps : Maniack, tostaki, Moul, ljf
  • Infra : opi, Bram, ju, Moul
  • Com
    • Com : Bram, Moul
    • Doc : Moul, theodore
    • Trad : Jean-Batiste

Décisions à venir pour les groupes

Conseil

  • Faut-il élire les membres du conseil plutôt que de les coopter ? Risque de se transformer en "campagne politique"!
  • Faut-il limiter l'ouverture des groupes d'intérêts par cooptation comme pour le conseil ?
  • Proposition de changer Conseil en Collégiale
  • Migrer le serveur dinfrastructure du projet sous YunoHost. (avec apps déjà packagées pad, gogs, mumble?)
  • Let's Encrypt
  • Nouveau système pour la documentation
  • Amélioration de la documentation
  • Migration du serveur XMPP
  • Hébergement de notre forge git
  • Revoir système de build : stable <— testing <— branches
  • Gel de nohost.me et question de l'abandon des services

Groupes Dev

  • Comment gérer les pull request ?
    • Chaque ticket fait l'objet d'une branche et d'un ticket, tu fais une pull/merge request, la communauté vérifie que ça fonctionne, une décision est prise d'intégrer.

Groupes Apps

  • Pour les apps communautaires, les issues sont bien sur Github, les discussions sur le forum

Support

  • Rapport de bug à partir du forum
  • Faire en sorte de nettoyer le forum pour éviter le bruit
  • Proposition de supprimer le salon de support

Autres

  • Demande sur le forum avec notification des membres du conseil et des représentants des groupes dintérêts concernés.
  • Vote sur deux semaines par un post sur le forum
  • Créer quatre canaux pour le Dev, les Apps, la Communication et l'Infrastructure
  • La release devrait être validée par l'ensemble des 4 (ou 5) groupes dintérêts
  • Communication en français et en anglais
  • Annuaire ou contact des groupes pour les nouveaux arrivants. Voir peut-être annuaire tout court pour savoir qui fait quoi. https://yunohost.org/#/contribs_fr à compléter. Et à mettre en avant.
  • Proposition de laisser les membres YunoHost s'auto déterminer -> Comment gérer les accès ?

Notes

Moyens de communication actuel :

  • IRL
  • Réunion Mumble
  • Forum
  • Listes de diffusion : contrib et app
  • Bugtracker Redmine
  • Forge git pour les review de code sur les PR
  • Salon de discussions XMPP

F.A.Q ?

Quelle différence avec d'autres projets (ArkOS, Cozy, Sandstorm, etc.)

  • Cozy : gouverné par une entreprise qui développe toutes les applications pour une meilleure intégration entre-elles. Basé sur Debian.
  • Sandstorm : distribution proche de la distribution YunoHost.
  • ArkOS : en développement, basé sur Arch GNU/Linux.

Pourquoi continuer YunoHost ?

La communauté de YunoHost est grandissante et beaucoup de gens comptent dessus, son architecture technique basée sur des logiciels existants et sa gestion entièrement communautaire en font un projet unique. Enfin parce que c'est amusant et que l'aventure est belle :)

Références