Я согласен, что документацию по плагинам необходимо обновить на данном этапе. Цель периода «депрекации», когда плагины всё ещё работают, но сайт выводит предупреждение о том, что они скоро перестанут функционировать, — дать авторам плагинов достаточно времени для их исправления. Однако в этот период даже команда штатных разработчиков не смогла обновить основную документацию по разработке плагинов. Это странное требование предъявлять к отдельным разработчикам, если команда не может полностью справиться с этим за тот же срок.
Для меня это сигнал о том, что скорость разработки слишком высока и/или авторы плагинов не являются приоритетом для Discourse. Лично я считаю, что дело скорее во втором. Я понимаю, что чем-то приходится жертвовать, поэтому это моё наблюдение, а не критика. Discourse по-прежнему полностью настраивается через плагины, и я ценю непрерывные улучшения.
Тем не менее, я считаю, что мы достигли момента, когда пошаговое руководство по созданию базового плагина устарело. Теперь для начинающего автора плагина достаточно одного контекстного документа для ИИ-агента, который сможет прочитать его и создать скелет плагина. Более того, для открытой кодовой базы, такой как Discourse, документация вообще не нужна, поскольку агенты получают контекст напрямую из самой кодовой базы. Когда я работал над своими плагинами, я видел, как Claude изучал существующие плагины, чтобы понять шаблоны проектирования. Мне даже удалось найти ошибку в основном коде: Chat Pitchfork timeouts: replies silently create threads and auto-tracking bloats over time
В общем, для любого, кто читает это и стремится стать начинающим автором плагина: документация может быть устаревшей, но создавать плагины сейчас в 1000 раз проще, чем когда-либо прежде.