In a post to his site Matthieu Napoli shares some of his thoughts about "code style rationality" including code formatting in general and some suggestions on one of the harder things in development – naming things.
Habits are sometimes making us blind. We think X looks prettier than Y but that’s just the habit speaking. In this article I’ll try to take a rational approach at coding style. That means leaving the “it looks ugly/better” at the door.
If at any point you feel like something “just doesn’t look good”, breath in, breath out, and try it! Nothing beats hands-on experience, not even some random article on the internet.
He looks at a few subjects specifically (there’s way too many to cover them all in detail):
- the use of trailing commas
- alignment of values in docblock comments
- keeping docblock comments minimal
- using the "Interface" suffix
- using the "Exception" suffix
He ends the post by reminding readers that the point is to think about code style logically and that no rules are written in stone.