Writing code that any programmer who read can understand is a for software developers. The fact is: only 20% of the programmers have the ability. must-have skill “Any fool can write code that a computer can understand. Good programmers write code that humans can understand.” — Martin Fowler When I started caring about code readability I noticed that my code started to be: easier to maintain easier to refactor reusable consistent The Book is the clean coder programmer bible. This book talks about code, behaviour, automated tests and so on. Robert "Uncle Bob" Martin's "Clean Code: A Handbook of Agile Software Craftsmanship" Let's get practical! Writing meaningful names. One of chapters talks about meaningful naming. In this story, you are going to be the code reader. Take a look at this function: Clean Code def calc(n1, n2)return n1 / n2end Do you think "calc" is a good name for this function? Uncle Bob would say: no! Why? “calc” is an : don't! abbreviation Functions do something. It must be named with a . verb Even I rename "calc" to "calculate", it still be vague. We need to improve the by giving the function name more meaning. semantics This function divides two numbers. "divide" is a good name for it. def divide(n1, n2)return n1 / n2end result = divide(1, 2) We still have problems with it. "n1" and "n2", the parameters, are not semantic. What if we call them "dividend" and "divisor"? The same thing to the "result" variable. It should be called something like "quotient". def divide(dividend, divisor)return dividend / divisorend quotient = divide(1, 2) Much more semantic! If you are not convinced to read this book yet, take a look in this picture and buy this must-read book! Thank you for reading! Don't forget to follow me on , and . Medium Instagram LinkedIn

Instagram

You Are Not Paid to Write Code

What Ruby taught me

Mastodon

Too Long; Didn't Read

Make resilience your competitive advantage

The Book Every Programmer Should Read

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

3 Things I Learned in 1 Year Working with Functional Programming

10 Websites That You Should Know About

1000 Stories To Learn About Hackernoon Books

10 Cybersecurity Books Every Business Owner Should Read

10 books I wish I read before starting up

3 Things I Learned in 1 Year Working with Functional Programming

10 Websites That You Should Know About

1000 Stories To Learn About Hackernoon Books

10 Cybersecurity Books Every Business Owner Should Read

10 books I wish I read before starting up

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps