Y a-t-il une convention de nommage pour les projets de composants de thème ?

Dev
1

Existe-t-il une convention de dénomination pour les projets de composants de thème, afin qu’ils soient facilement reconnaissables comme tels ?

Lorsque l’on voit le dossier sur le disque, ou le dépôt sur GitHub ou le projet sur GitLab ou une autre forge de code, il serait utile de pouvoir voir d’un seul coup d’œil que :

  • ceci doit être utilisé avec Discourse
  • c’est un composant de thème (par opposition à un thème Discourse complet, un plugin Discourse, ou quelque chose de différent)

Existe-t-il une convention existante sur la manière de communiquer cela dans le nom ou le slug ?

1 « J'aime »
2

Nous n’imposons aucune convention de nommage… l’équipe Discourse préfixe souvent les thèmes et les composants avec discourse-, mais ce n’est pas universel.

Au-delà du nom du répertoire, nous espérons que le fichier readme inclura un peu de contexte indiquant que c’est pour Discourse… sinon, les thèmes et les composants de thème ont toujours un fichier about.json avec quelques informations, et les plugins contiendront un fichier plugin.rb.

2 « J'aime »
3

J’utilise discourse-tc- pour signaler un composant de thème car c’est une bonne pratique et pratique pour distinguer ceux-ci des thèmes et des plugins.

3 « J'aime »
4

J’aime ça, car c’est assez court, mais informatif.

Quelle convention de dénomination (le cas échéant) utilisez-vous pour les thèmes et les plugins ?

5

Même chose ici

  • discourse-foo pour les plugins
  • discourse-theme-foo pour les thèmes complets
  • discourse-tc-foo pour les composants de thème
3 « J'aime »