Publique - Outil pour discuter et documenter nos décisions - Utiliser ADR dans ce forum

Décisions publiques du collectif IndieHosters
1
  • Status: accepté
  • Personnes décideuses: AnneSo, Arnaud, Hugo, Tim J, Tim G et Pierre
  • Étapes idéales selon la personne qui propose:
    • proposition (clarification, ressentis, amendements):
      • sur le forum en async
      • discussion au point hebdo Vendredi 23/08
    • Date de fin idéale: point strat le 27/08/2024
  • Discussion: privée
  • Publication: publique

Contexte et description du problème

Dans IndieHosters, nous avons besoin d’un outils pour proposer des décisions, les discuter, les amender et les accepter.

L’équipe technique commence à utiliser cette technique depuis plusieurs semaines et en est très contente.

ADR veut dire Any Decision Record.
Et le M est pour le format Markdown.
(Pour simplifier, on va juste parler de ADR, qui est plus communément admis sur Internet)

Facteurs pris en compte dans la décision

  • basée sur un logiciel libre
  • lisible par les organisations et les personnes contributrices
  • lisible par le public en général
  • que le public en général puisse aussi donner son avis
  • facile à relire
  • facile pour que le collectif s’empare de l’outils

Options considérées

  • ADR dans notre forge logicielle
  • ADR dans Nextcloud
  • Nextcloud form
  • Un pad de pads hedgedoc
  • Un dossier Nextcloud avec des md dedans

Décision

Utiliser Any Décision Record (ADR) dans ce forum.
Le template pour un nouveau post est ici.
La documentation de ce process est ici (temporaire, sera ensuite sur le git public-kb si tout le monde est ok).

Consequences Positives

  • les discussions dans discourse sont agréables
  • Discourse permet qu’un article devienne une page de wiki, ainsi, tout le monde peut s’emparer de la proposition/décision et la bonifier
  • Il est facile dans discourse d’avoir des templates
  • le forum est facilement accessible depuis Internet et est déjà joli
  • l’outil est déjà utilisé, pas besoin d’un nouvel outils

Consequences Négatives

  • l’équipe tech préfère git, mais le commun des mortels non
  • utilisation d’un autre logiciel que Nextcloud
  • ajout d’un nouveau logiciel important dans la vie de tous les jours du collectif

Pours et contres des différentes Options considérées

madr dans notre forge logicielle (git)

  • pour: git est un beau workflow
  • pour: cela permet de faire des jolis sites avec après
  • contre: git peut être obscure et intimidant pour les gens
  • contre: nos contributeurices n’ont, pour la plupart pas de comptes sur notre git

madr dans Nextcloud (dossier)

  • pour: utilisation de Nextcloud, comme nos contribs
  • contre: Nextcloud n’est pas forcément un outils adapté de forum pour le public

Nextcloud form

  • pour: c’est facile à remplir
  • pour: même technique que la fresque du climat
  • contre: pas facile de commenter/ faire communauté autour ce cet outils

Un pad de pads hedgedoc

  • pour: hedgedoc fonctionne bien pour écrire du md ensemble
  • contre: on risque de perdre ces pads
  • contre: difficulté de commenter
  • contre: difficulté de les trouver pour la communauté

Liens

2