humancode.us

The Midway

November 12, 2018

The Midway

View this photo in my flickr photostream

The Midway neon sign at Dave and Busters in Milpitas, CA.

📷 Nikon D800, Nikon 24–70mm f/2.8. 24mm, f/2.8, 1/80s, ISO 1250

Doing Better With Technical Terms

November 10, 2018

As the engineering profession becomes more inclusive, we need replacements for terms that may conjure up prejudice or bias. Here are some suggestions for improvements:

Instead of… How about…
whitelist / blacklist allow-list / deny-list
master/slave main/backup (backup is not used until main fails)
director/performer (director tells performers what to do)
leader/follower (leader performs action, followers mimic behavior)
overview/detail (overview provides navigation, detail shows…details)
male connector plug
female connector port, socket, receptacle1
sanity test robustness test, basic operations test (specify what you’re testing)
blackout power outage, power failure
brownout partial power outage, voltage dropout

What other terms can you think of?

  1. Avoid using the term “jack” to mean “receptacle”, because the term may cause confusion between the US and UK.

Don’t Hire a Smart Asshole

November 8, 2018

You may be tempted to hire a smart asshole into your team. Think long and hard before you do this. Don’t underestimate an asshole’s natural ability to ruin your team’s morale; to intimidate junior engineers; to become territorial about code and ideas; and to turn a productive hallway into a toxic environment.

Is an asshole’s genius really worth more than the loss of a good team dynamic? In twenty years I have never seen a single instance where a team wouldn’t be better off without them. Your odds are probably about the same.

Great reference: The No Asshole Rule

Call Out Risks Up Front

October 11, 2018

When recommending an architectural or strategic direction, be sure to prominently call out the major risks involved in your proposal.

You might be tempted to paper over the risks involved in your proposal, probably because you think others will be more attracted to your plan that way. If you do this, you will appear dishonest, because you are.

An honest engineer is ready to acknowledge that all proposals carry risk. Calling them out up front shows that you have nothing to hide. This—maybe somewhat paradoxically—will lead other engineers to trust you more, not less.

Good Side Projects

August 26, 2018

A really fun kind of side project is one that is barely related to your product, yet still in the realm of potential usefulness; something that makes your colleagues say “that’s might be cool, but we’ll never get funding for it”.

Not only are these side projects great fun to do (because of their inherently fun and toy-like nature), they often give you deep insights about your main product, and help widen your team’s imagination of what is possible to implement.