Engineering on Stephen Shary

Make the Right Way the Easiest Way

Mon, 01 Jan 0001 00:00:00 +0000

When working with other engineers, we should assume that their work will be like water flowing downstream. When they hit an impediment, it will slow them, but they will find a way around it. Their role is to build things to solve a problem.

Understanding this, we should strive to build an environment where the right way to do something is the easiest way to do it. Anything that helps an engineer complete their job in a faster, easier, and better way will become a new tool or method that they will use. The greater the impact of that tool or technique, the more likely they are to use it.

Steps to Solve a Bug Correctly

Mon, 01 Jan 0001 00:00:00 +0000

There’s a right way and a wrong way to fix a bug. Done correctly, a fix addresses the root cause, not just the symptoms, and includes a test to prevent regression.

Steps to fix a bug correctly:

From the telemetry, and side effect output, determine the inputs that cause the bug consistently.
- It is common that not enough information is available to understand the issue, add more telemetry if needed and repeat step 1.
Add an automated test (at the correct level) that replicates the issue.
- More than one test may be necessary to fully define the “edge cases” of the bug.
- This is only possible if you truly understand the root cause — a test written against a symptom gives false coverage.
Write the minimal code needed to make the test pass.

Thought: There are many people that can aleviate a symptom, but the best solution is one that tackles the issue. Be the person that knows the “why”.

Why is the path beyond Sr. Engineer difficult?

Mon, 01 Jan 0001 00:00:00 +0000

The path to continue beyond Sr. Engineer is difficult for several reasons. In my experience, the difficulty stems from how career progression typically works for managers. Many managers in the technical field will start as an engineer and then continue for 3 - 5 years in which they become competent to handle larger and more complex tasks. After that period of time, the avenue of management opens up and there are opportunities to move all the way up to CEO, a long and lucrative ladder.