Créer un plugin pour Discourse qui publie le contenu de fichiers spécifiques d’un dépôt directement dans un sujet
Le cas d’usage prévu pour un tel plugin serait de gérer le contenu d’abord sur GitHub (avec contrôle de version, suivi des problèmes, demandes d’extraction, etc.), tout en maintenant la branche principale toujours synchronisée avec un sujet spécifique
Les cas d’usage incluraient des choses comme des guides, une base de connaissances, un dépôt d’idées
Plus précisément, notre cas d’usage interne est que nous utilisons Discourse comme centre de connaissances, mais nous souhaitons un contrôle plus précis sur la mise à jour et l’édition du contenu, d’où l’intérêt du flux Git
Quelques notes supplémentaires
Doit uniquement fonctionner avec des fichiers .md
Nous aimerions que ce projet soit open source (nous couvrirons les coûts de développement initiaux)
Quand avez-vous besoin que ce soit fait ?
Le calendrier n’est pas immédiat, mais dans les prochains mois
Quel est votre budget, en dollars USD, que vous pouvez offrir pour cette tâche ?
La portée n’est pas encore entièrement claire, il faudra donc la déterminer en premier lieu.
Qu’est-ce qui manque à Discourse à cet égard ? Discourse peut-il être amélioré pour répondre à vos besoins afin que vous n’ayez plus besoin d’utiliser GitHub ?
Vous mentionnez les pull requests, donc peut-être que le besoin est la possibilité de demander des modifications qui sont ensuite examinées et approuvées par une autre personne avant qu’un changement ne soit finalisé ? Je suppose que vous pourriez le faire « à la manière de Discourse » en répondant au message pour demander une révision ou en l’assignant à quelqu’un après avoir effectué le changement. J’ai eu du succès en configurant un minuteur de sujet pour supprimer automatiquement les réponses, afin que le sujet ne soit pas encombré par de nombreuses petites réponses.
Une autre idée serait d’utiliser le plugin de politique. Un groupe pourrait être notifié lorsqu’un sujet a été modifié et invité à confirmer qu’il a lu et accepté le changement.
Cela dit, je pense que c’est une idée plutôt géniale et j’aimerais la voir mise en œuvre. Je vois cela utile même pour Meta ! Nous avons de nombreux sujets ici concernant des dépôts GitHub et ce serait agréable de voir les mises à jour des fichiers readme.md de ces dépôts dans le premier message, afin qu’ils n’aient pas à être maintenus à deux endroits.
Pour Discourse for Teams, cela pourrait également être une fonctionnalité utile, afin que les équipes qui utilisent beaucoup GitHub puissent toujours utiliser Teams comme leur « source unique de vérité » pour les références, sans que chacun doive se connecter à GitHub tout le temps. Je suppose que cela pourrait faire partie ou être un complément au plugin de revue de code ?
Le point majeur ici est la gestion des branches. La motivation principale réside dans l’existence d’un mécanisme permettant de créer une branche, d’y apporter des améliorations, de la réviser, puis de la fusionner. De même, cela permet à un réviseur de suivre un processus similaire en apportant des modifications mineures à la branche elle-même, offrant ainsi un contrôle plus précis sur les changements.
Bien que j’aimerais beaucoup que ce soit le cas, les éléments manquants sont un peu complexes :
La gestion des branches
La fusion des modifications en un seul clic
C’est une excellente astuce pour toute personne qui accorde moins d’importance à l’aspect de la gestion des branches que moi dans ce cas précis.
On a l’impression que cela pourrait être extrêmement utile à bien des égards. Chaque fois que je trouverai la bonne personne à embaucher pour cela, j’aimerais bien collaborer un peu. Peut-être que cet outil finira par devenir un plugin « officiel » ! (on peut toujours rêver).
Si le cas d’usage central concerne les fichiers .md et un langage commun, je pense toujours que Discourse présente un grand avantage : il est conversationnel et permet aux gens de vraiment discuter entre eux dans un langage clair. Comme vous l’avez dit, vous souhaitez généralement que cette conversation sur les connaissances ait lieu sur Discourse. Il vaut donc la peine d’examiner comment garder la majeure partie de tout cela directement là-bas ; sinon, vous détournerez l’attention et la concentration de ce que vous souhaiteriez voir comme votre plateforme principale.
Je pourrais imaginer une configuration comme suit :
Un fichier Readme.md en tant que sujet de wiki sur Discourse, synchronisé avec GitHub.
Des discussions à propos de ce Readme sous forme de messages de suivi sur Discourse, régulièrement supprimés (similaire à la configuration actuelle sur meta).
Des fichiers et dossiers supplémentaires dans un dépôt gérés sur GitHub avec des branches. La structure actuelle du dépôt pourrait être synchronisée vers Discourse, afin qu’elle s’affiche avec le message de wiki comme une table des matières.