Documentation avec GitLab Pages

Bonjour,

Suite à la discussion Documentation partagée de type Wiki, je voudrais mettre en place une documentation avec GitLab de la manière suivante :

  • Réserver un dossier dans File de Nextcloud pour la documentation qui sera ainsi accessible hors-ligne avec un éditeur de bureau bien ergonomique (de type Obsidian ou Zettler).
  • Faire une routine de sauvegarde GIT vers le wiki d’un projet GitLab
  • Publier la documentation en utilisant GitLab Pages (en suivant la piste des opérateurs kubernetes)

Cela semble jouable ?

Ai-je un accès au GitLab de Indiehosters avec mon compte beletre ? Et si oui, avec quel espace de stockage ?

Bonjour, je propose qu’on s’appelle?

Envoyez un mail sur hello at indiehosters.net et on continue la discussion, ce sera plus facile :slight_smile:

On mettra la solution envisagée sur ce forum.

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 :upside_down_face: !

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 :slight_smile: