Je suis d’accord pour dire que la documentation des plugins doit être mise à jour à ce stade. L’objectif de la période de « dépréciation », durant laquelle les plugins fonctionnent encore mais où le site affiche un avertissement indiquant qu’ils tomberont bientôt en panne, est de donner aux auteurs de plugins suffisamment de temps pour les corriger. Pourtant, durant cette période, une équipe de développeurs à temps plein et rémunérés n’a pas pu mettre à jour la documentation de développement du plugin principal. C’est une attente étrange à imposer à des développeurs individuels alors qu’une équipe ne peut pas pleinement la gérer dans le même laps de temps.
Pour moi, cela indique que le rythme de développement est trop rapide et/ou que les auteurs de plugins ne constituent pas une priorité significative pour Discourse. Personnellement, je pense qu’il s’agit davantage de ce dernier point. Je comprends que certaines choses doivent être mises de côté, il s’agit donc d’une observation de ma part plutôt que d’une critique. Discourse reste entièrement personnalisable via des plugins, et j’apprécie les améliorations continues.
Cela dit, je pense que nous en sommes arrivés à un moment où un guide de documentation étape par étape pour créer un plugin de base est une idée obsolète. Un seul document de contexte à lire pour un agent afin de construire un squelette de plugin est désormais tout ce dont un auteur de plugin amateur a besoin. En fait, pour une base de code open source comme Discourse, la documentation n’est même plus nécessaire, car les agents obtiennent leur contexte directement à partir de la base de code elle-même. Lorsque je travaillais sur mes plugins, j’ai vu Claude lire les plugins existants pour apprendre les modèles de conception. J’ai même pu identifier un bug dans le code principal : Chat Pitchfork timeouts: replies silently create threads and auto-tracking bloats over time
En résumé, pour toute personne qui lit ceci et aspire à devenir un auteur de plugin amateur, la documentation peut être obsolète, mais il est 1000 fois plus facile de créer un plugin aujourd’hui qu’auparavant.