Proverbs of Programming

2024-08-19 | 2 minute read | 215 Words
 #programming

I’ve learned countless lessons throughout my time programming. These proverbs range from good advice, to a cure to shooting your own foot.

A Little Copying Beats a Little Dependency

There is value to copying 2-3 simple things directly into your code rather than pulling in a dependency. More generally, its better to re-write code rather than pull in a dependency.

Simplicity is Sage

When code is simple, it infers readability, easy to build, and easy to port. Simplicity also makes interfacing with code much easier since it is simple. However, simplicity does not necessarily infer easy conceptual understanding, but rather, there isn’t excessive abstraction.

Brevity is the Pillar of Clarity

Short and sweet. You could consider this an extension of the above, but I think it is standalone. The more “stuff” you add to something, the less clarity there is on what that is. Five words versus Five-Hundred words makes a difference.

Fools are Clever

If something is clever, good luck showing anybody how it works. The more clever something is the less understandable it is.

Documentation is for Users

Documentation is something many fail to nail. Anyone who consumes your documentation is a user and will not know everything about your code. Thus, treat them like users and everyone will like what you write.

<= Previous Next =>

Liked the article? Send it to a friend!