Ok, donc nous avons discuté.
Déjà, dans les grandes lignes, c’est un sujet qui nous fascine.
Content as code nous avait déjà bien émoustillé les neurones!
Et une plongée dans la galaxie du groupware sur wikipedia avait fini de m’achever!
J’en retiens plusiurs choses que je vais essayé de vous partager.
D’abord, l’email et une suite office, c’est un peu le niveau 0 de la collaboration.
Ces outils sont très utiles, et très versatiles, mais pas très spécifique.
Si nous voulons, par exemple, suivre les demandes de support faite sur la plateforme Liiibre, il est possible d’utiliser l’email, cela fonctionne. Mais il existe aujourd’hui des outils plus puissants, comme zammad (que nous utilisons) qui permettent de mieux collaborer autour de la gestion de tickets.
Pour la suite office, si on prend l’édition de document texte, c’est pareil. je peux écrire un livre avec LibreOffice. Mais aujourd’hui, il existe des outils plus adaptés pour écrire des livres en ligne, comme editoria (qui nous hébergions il fut un temps!).
Du coup, aujourd’hui, nous sommes dans un entre deux, où #lesgens sont habitués à leur suite office, et iels demandent de l’avoir pour collaborer dans le navigateur, et nous sommes frustrés par cela.
En interne, par exemple, nous utilisons beaucoup HedgeDoc pour la prise de note collaborative. Ce n’est pas encore intégré dans Nextcloud, mais à part cela, personnellement, j’adore!
En essayant de raccrocher les wagons avec la question initiale, quelle serait alors l’approche?
Si on discute ici, sur le web, c’est que nous sommes d’accord que le medium sera le web, c’est là où seront lu les documents, là où la collaboration aura lieu. Meme si cela parait évident, partir du postula que nous allons collaborer sur le web réduit déjà énormément le champs des possible 
!
La question suivante sera alors, qu’elle interface pour éditer, pour écrire le web? Et là, cela se complique déjà!
- est-ce qu’on veut éditer avec un « markup langage » (html, md, wikitest, rst… ) ?
- ou bien alors en « WYSIWYG » ?
Dans que format veut-on stocker la donnée?
- dans des fichiers plats (.md)
- openDocument (.odt)
- base de donnée
Et enfin, quel mode de collaboration veut-on?
- pour la lecture
- est-ce publique ou privé?
- pour l’écriture
- est-ce que n’importe qui peut éditer, et il est facile d’annuler un changement? (mediawiki)
- est-ce que le changement doit être approuvé avant d’etre en ligne? (git)
- est-ce qu’on veut conserver l’historique des changements (etherpad, mediawiki, git, Nextcloud)
- est-ce qu’on veut gérer finement qui a accès en lecture/écriture aux documents? (Nextcloud)
Si on revient sur la question de base, comment éditer une documentation à plusieurs, nous, en interne, avons fait un choix. Et celui ci se porte sur git+md+hugo+ci = website.
Vous pouvez le voir en action sur ce site par exemple:
https://k8s.libre.sh/problemtosolve/ (avec la possibilité de proposer un changement en cliquant sur le bouton en haut à droite)
Aujourd’hui, c’est assez manuel à mettre tout cela en place, et c’est ce que je proposais à @beletre
Voila, c’est un instantané de ma (notre) pensée du moment sur le sujet.
Aujourd’hui, dans le monde de l’open source, je ne pense pas qu’il existe encore LA solution qui réponde facilement à nos besoins de collaboration sur la documentation, mais cela se met en place petit à petit, et il reste des terrains à explorer 
