Майкл, ответ таков: изучайте существующие решения, так как документация быстро устаревает и обычно лишь поверхностно освещает тему. Напротив, популярные плагины часто поддерживаются в актуальном состоянии и охватывают более сложные сценарии использования.
За последние несколько лет я и мои коллеги научились именно этому — использовать существующие репозитории для понимания подходов к решению задач.
Я рекомендую в первую очередь посмотреть репозитории основной команды Discourse (official), затем репозитории Pavilion (pavilion) и мои собственные репозитории в качестве примеров того, как выполнять различные задачи (в указанном порядке! 
).
По мере развития платформы и появления новых версий зависимостей и новых возможностей, официальные плагины, использующие добавленные в платформу новые технологии, могут стать отличной отправной точкой.
Найдите плагин, который функционально решает задачу, похожую на вашу, и скопируйте его подход.
Вот пример плагина, добавляющего один маршрут: