Sim. É difícil de entender. Prefiro não pensar no número de vezes que gastei 3 horas em algo apenas para descobrir que nomeei algo errado ou o coloquei no lugar errado, ou às vezes, esqueci de incluí-lo de uma das muitas maneiras que existem para fazer isso (em plugin.rb, em um include em um arquivo js - qual caminho? Preciso de uma extensão?)
O melhor é usar Instale o aplicativo de console Discourse Theme CLI para ajudá-lo a criar temas e fazer com que ele crie um esqueleto de tema para você. E torna muito fácil depurar, pois ele o carrega automaticamente em seu servidor (um servidor de produção comum) e (geralmente) recarrega seu navegador automaticamente.
Não tenho ideia do que ou se há uma diferença (acho que não? Mas tenho pouca ideia). Eu usaria o que está no esqueleto do tema.
Existe um repositório chamado all-the-themes. Você pode obtê-lo e pesquisá-lo em busca de exemplos. E sempre use aquele que foi alterado mais recentemente.