Use less magic.

The code should communicate the intent of the developers.

Frameworks are very powerful and enable the software engineer to take a lot of shortcuts in development. Sometimes, these shortcuts appear to make things happen like magic. Unfortunately, sometimes too much magic results in confusion and a loss of clarity. So while the code may work properly and pass tests, it becomes a challenge for a future programmer to modify it correctly.

Do a favor to the next developer who has to look at your code and ensure that your intent is obvious. Developers typically spend much more time reading code than writing it, so it behooves us to write code that is easier to read and understand.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: