Com relação aos estilos, as principais alterações que vejo são que
- uma convenção de nomenclatura consistente é aplicada usando BEM
- há ainda mais propriedades personalizadas que são aplicadas de forma consistente
Para mim, isso torna a personalização do Discourse muito mais fácil e precisa. Mas, suponho que dependa do seu conhecimento de trabalho. Eu poderia imaginar que há uma curva de aprendizado mais acentuada agora para pessoas que apenas querem fazer alguns ajustes e não estão tão familiarizadas com CSS.
Sobre a documentação, você pode conferir o Guia de Estilo e, suponho que a maneira mais fácil de verificar quais propriedades personalizadas estão disponíveis é usando as ferramentas de desenvolvedor do seu navegador. Documentation também está sendo reformulada. Atualmente, existem duas seções em Documentation developer-guides, Temas e Componentes e Interface. Mas há uma enorme variação entre apenas querer declarar alguns estilos personalizados e criar um componente. Parte disso provavelmente está enterrada muito profundamente entre os tópicos de desenvolvedor? 