Remarques rendus : Laravel 2021 2022 revue de mi projet - HE-Arc/slides-devweb GitHub Wiki

README

Généralement contient une petite description du projet. Et les commandes pour pouvoir l'installer et l'utiliser.

Formatage et Lintage

Certains groupes s'appliquent pour appliquer une convention commune à tous les devs, d'autres groupes laisse cela un peu de côté. Qu'est-ce que vous diriez si je vous disais qu'il est possible d'ajouter des packages à votre projets / des extensions à votre IDE (VSCode dans notre cas) pour que la plupart de ces conventions soient appliqués automatiquement par tous les devs :) Il y a plusieurs normes / standards, je vous donne ici ce que je trouve pertinent, mais libre à vous de voir s'il y a plus pertinent pour votre projet.

  • VueJS : extension vscode Vuetur et Prettier, ESLint et ensuite configurez le tout dans VSCode pour que le formatage soit appliqué à chaque fois que vous sauvegardez votre code.

Indentation, espacement, retour de ligne et convention

Appliquer une convention pour votre code. Certains de vos codes sont compliqués à lire et à comprendre. Donnez-vous de la peine pour avoir des bonne indentations, espacement, retour de ligne et que le tout soit cohérent d'un fichier à un autre. Il existe également des outils pour le faire automatique ou presque à votre place dans VSCode. (Voir formatage et Lintage pour plus de détails)

Migrations

Ne jamais modifier une migration déjà poussée ! On l'a dit plusieurs pendant le cours et les workshop. Si vous avez besoin de modifier votre base de données, refaites une nouvelle migration à la place. C'est important de respecter cela, car cela peut avoir un impact considérable dans une application en prod p.ex. Autant prendre l'habitude directement.