Un Petit Guide pour Nommer les Composants
by Angela Fisher, Développeuse Front-end
1. La Brièveté est Clé
Le temps est précieux, ne le gaspillez pas en tapant des noms de composants longs et descriptifs. Une approche consiste à leur donner des noms courts et cryptiques que vous seul comprendrez.
Besoin d'un bouton ? Appelez-le "btn". Une modal ? Et pourquoi pas "md"? Vous économiserez des minutes précieuses par jour et vous bénéficierez de l'avantage supplémentaire d'être la seule personne dans le codebase à savoir où se trouve chaque chose. Cela s'appelle la sécurité de l'emploi.
2. Figurer en Haut dans les Recherches
Lorsque vous travaillez dans des dépôts volumineux avec de nombreux collaborateurs, il est important que votre composant figure en haut des résultats de recherche.
Une manière de se démarquer est d'inclure tous les termes de recherche possibles dans le nom de votre composant. Au lieu de "SignInButton", vous pourriez l'appeler "SignInButtonAuthenticationCookieUserLogIn", ce qui garantira qu'il sera retourné dans presque tous les résultats de recherche pertinents.
3. Mélanger les Langues
Si vous travaillez à distance, il est probable que vous fassiez partie d'une équipe mondiale et pourtant, tous vos composants ont des noms anglais. Cela ralentit considérablement vos collègues non anglophones, vous devriez donc leur permettre d'utiliser leur langue maternelle pour nommer les composants.
Vous pouvez créer un fichier d'index qui mappe toutes les langues différentes utilisées dans votre dépôt. Besoin d'une liste déroulante ? Cherchez "Desplegable". Un formulaire ? Recherchez "Форма". Vous apprendrez plusieurs nouvelles langues tout en étant plus inclusif envers vos collègues.