2. Github pour le moment sert uniquement à héberger le code. Auj : repo privés, pas ou peu documentés.
Ce que je me disais : il y a déjà dans github un tas d'outils intégrés (wiki, issue tracker, etc) qui pourraient être exploités pour automatiser et éviter de la redondance (README ou /doc utilisé comme documentation aussi visible par des néophyte sur le site ?). Mais je suis p-ê trop à donf de github.
Je crains la duplication de contenu chronophage pour eux, en fait.
@clairezed Ce qui pourrait être fait :
- mise en place d'un générateur de site statique, avec GitLab ou GitHub ;
- utilisation de Netlify (ou autre) pour avoir une interface d'administration ;
- utilisation des issues GitHub ou GitLab pour les commentaires ;
- utilisation directe de GitHub/GitLab pour les plus techs pour intervenir sur la documentation ;
- etc.
@antoinentl
Sur ce que tu proposes, je vois des contraintes :
- nécessité d'avoir un compte github (on peut pas faire d'issue ou de PR sans être inscrit, si ?)
- github, même si ça nous paraît à nous évident, est pas accessible à tout le monde. Ils me disaient que même en interne, tout le monde est pas à l'aise avec le système d'issue.
Ou alors tu a en tête une façon de faciliter l'authentification et la rédaction sur github ? (j'arriverais aps à la convaincre de se mettre au .md...)
@antoinentl ok sur les besoins, mais avec comme toile de fond le fait que 2 outils soient déjà utilisés par l'équipe.
Mon premier réflexe plutôt que de faire partir ma réflexion du néant était donc de voir ce qu'il est déjà possible de faire à partir de ces deux outils
@clairezed oui oui je vois bien ! Ça peut peut-être aussi se gérer via les commentaires de Wordpress, mais ça me semble assez merdique comme solution 🤔 Il faudrait regarder du côté des *headless CMS*, je crois que Wordpress peut effectivement être détourné, comme tu le suggérais (voir https://www.contentful.com/r/knowledgebase/headless-and-decoupled-cms/ ?)
@antoinentl oh punaise, l'heure qu'il est ! Il faut que je file acheter un cadeau pour la nièce de Camille 😬 désolée, faut que je te laisse en plan
@clairezed on en reparle, mais ça mériterait un atelier !
@antoinentl graaaave
@clairezed Là comme ça j'ai l'impression qu'il y a 4 besoins :
1. présenter les outils
2. documenter les outils
3. discuter autour des outils
4. ouvrir la modification de la documentation des outils
Plutôt que d'essayer de coller une techno sur un besoin, il faudrait décortiquer et articuler ces besoins 😅
Après utiliser Wordpress + Git me semble un peu audacieux (surtout en terme d'usages pour l'équipe).