Évitez la surcontextualisation

Ajouter du contexte et s'assurer de l'expressivité de vos lignes est primordial afin de conserver une bonne compréhension de votre code.

Cependant, soyez attentif à ne pas surcontextualiser en ajoutant des informations qui seraient inutiles ou superflues à la compréhension du code :

PostService->removePost($post);

La récurrence du mot "post" dans le nom de la méthode est superflue et n'apporte aucune information supplémentaire sur les intentions de votre code.

Surcontextualiser ajoutera du bruit qui nuira à la compréhension et à la facilité de lecture de votre code :

PostService->remove($post);

Assurez-vous que les noms de vos méthodes et variables restent clairs et sans ambiguïté quant à leur finalité et privilégiez des noms courts et équivoques lorsque cela est possible.

Visez l'essentiel et l'explicite dans le nommage de votre code.