Clean Code Craftsmanship

Undergoing a recent change in paradigm as to what coding means to me. I have the first prompt to undergo a session with the book “Clean Code” by Author Robert C. Martin. I would be putting out important one liners as I go through this Agile Software Craftsmanship grail.

Below are some of the points I picked;

If names must be different, then they should also mean something different

…smaller classes and shorter functions so that people can usually see the point of declaration of each variable they’re using

One difference between a smart programmer and a professional programmer is that the professional understands that clarity is king

A class name should not be a verb

Methods should have verb or verb phrase names

Choose clarity over entertainment value

Say what you mean. Mean what you say.

Pick one word for one abstract concept and stick with it

Don’t Pun… Avoid using the same word for two purposes

Remember that the people who read your code will be programmers. So go ahead and use computer science (CS) terms, algorithm names, pattern names, math terms, and so forth

Separating solution and problem domain concepts is part of the job of a good programmer and designer. The code that has more to do with problem domain concepts should have names drawn from the problem domain

you need to place names in context for your reader by enclosing them in well-named classes, functions, namespaces, or prefixing the name may be necessary as a last resort

The hardest thing about choosing good names is that it requires good descriptive skills and a shared cultural background