Да. Это сложно понять. Я предпочитаю не думать о том, сколько раз я тратил 3 часа на что-то, только чтобы обнаружить, что назвал что-то неправильно или положил не в то место, а иногда просто забыл включить это одним из множества способов (в plugin.rb, в include в JS-файле — какой путь? Нужно ли расширение?)
Лучше всего использовать приложение командной строки Discourse Theme CLI для помощи в создании тем, чтобы оно создало для вас шаблон темы. Это также упрощает отладку, так как оно автоматически загружает тему на ваш сервер (обычный продакшн-сервер) и (как правило) автоматически перезагружает ваш браузер.
Не знаю, есть ли разница или какая именно (я не думаю, что есть? Но я мало что понимаю). Я бы использовал тот, который находится в шаблоне темы.
Существует репозиторий под названием all-the-themes. Вы можете скачать его и поискать примеры. Всегда используйте тот, который был изменён более недавно.