Epistemological Models

2 Mar 2021

If you've read a handful of my posts I don't think you would be surprised if I told you I am an academically-minded person. There are a fair number of causes for this (which I am learning about more and more) and there are plenty of reasons why that would be a surprising development.

As a kid, I was "good at math". The truth is more that it came very easily. However, it never engaged me. It was easy and boring. I still have not done a lot of math in my day, though I wish I did more. I wish they taught math differently because when I see the kind of work that Grant Sanderson does at 3 Blue 1 Brown I am positively riveted. Even though I am entirely incapable of actually doing that math—it would take a lot of work now to even attempt getting there.

The link between high-level math that looks so interesting, my "academic-ness" nature, and my career in software revolves around the question of "How do we know what we know?" In my mind this boils down to two famous sayings: "All models are wrong, but some are useful" and "Don't confuse the map for the territory."

Grant Sanderson wields his understanding of high-level maths by fitting a solution to a real-world problem. He answers "How do we know how to solve this problem?" by reframing the problem in terms of a system of math that can generate an accurate and useful answer. For those who don't enjoy math, but have seen "Hidden Figures", this is precisely what Dorothy Vaughn did to solve their trajectory problems by picking a different mathematical system that would give them an answer they can use. In the view of people without this kind of mathematical mastery, it looks like they are wizards, or they are merely cheating—making up answers as they go along.

We know that computers only do what they are told. Decades ago you had the ability to see and understand everything the computer was doing. Not today, there are too many layers and too many authors of code in every machine running today. Computers are still doing exactly what they are told. There are just too many authors yelling at the computer.

This is the root of bugs. The computer is doing what it is told. The problem is us. We got an unexpected response. It is our understanding that is flawed. The "territory" is what it is. Our "map" is wrong.

We are wrong constantly. This means that we should always be learning. Many people are afraid of being wrong. I've never understood that perspective. Learning oftentimes means you were wrong. After all, it's rare that we go out of our way to truly learn something from zero knowledge. More often we are adding to the knowledge, and more importantly, changing the knowledge we have. Updating our maps, not treating them as dogmatic truth to rely on.

Read more: Epistemological Models

If You Want To Get Something Done

2 Mar 2021

About the time I was heading off to college I was introduced to an interesting phase. I am not entirely sure where I heard it, but I believe it was from my Aunt. Throughout her career she worked at IBM, Dun & Bradstreet, and Hewlett Packard. The saying went something like this: "If you need something to get done, give it to someone who is very busy."

As a kid who had never had a white-collar job before I didn't understand it. It still flies in the face of conventional thinking; surely you should give a task that needs to get done to people who have free time to do it. Only as my career has advanced am I beginning to understand the inherent wisdom in the phrase.

The first layer of understanding this wisdom is Parkinson's Law: "work expands to fill the time allotted." In the context of delegating an important task that needs to be completed; if you give the task to someone with enough free time the task will take longer. Delegate accordingly.

The second layer of understanding this wisdom, you'll discover, is that some people aren't interested or motivated. It is incredibly rare to see a skilled and ambitious person twiddling their thumbs waiting for something to do between 9 and 5. That said, staring at the ceiling trying to figure out the right decision to make counts as working for many of us. If something is urgent, out of the ordinary, or outside someone's comfort zone (and they haven't agreed to a stretch goal) you may reconsider delegating to this person.

Make no mistake, this is not about "a lack of trust". You trust the person to do their job, if you don't they shouldn't work there. But oftentimes things that need to get done lie on blurred lines.

Read more: If You Want To Get Something Done

Both Big & Small

30 Nov 2020

There are some engineers that excel at delivering small pieces of high quality work. Like a metronome they consistently deliver. There are other engineers that pull large and complicated projects across the finish line, without the sense of a death march or moving the goal posts. You need both these kinds of engineers in order to stay afloat.

Even better yet there are engineers who can do both of these things at the same time. In addition to shipping the big project there are some smaller pieces in there as well.

If you don't have an organization that can ship the small things, you'll die by suffocation. The communication and administration cost will be so high that you'll never be able to keep track of everything, no matter how hard you try. Why? Because there is a never-ending list of small things that will always grow. If you never ship against this list it will never get smaller.

If you don't have an organization that can ship the big things, you'll fall behind. New competitors will outflank you. You'll be left behind by technological changes and engineering techniques. Slowly your organization will lose its standing in the market.

Your folks will naturally gravitate towards one of these poles. Try and cultivate people at both ends. You'll need them.

Read more: Both Big & Small

Layers, Complexity, and Trends

15 Oct 2020

There is a short post that I cherish called: Complexity Has To Live Somewhere. Sometimes engineers need to be reminded that if everything was simple, clean, and easy, we wouldn't be getting paid. It is our job to create the interfaces, the abstractions, and the patterns that place the complexity where it belongs.

The truly insidious part about complexity is accidental complexity. To use a metaphor it is: "the cost of doing business." Accidental complexity is all the other crap that you have to do before you can do what you need to do. There are lots of reasons for accidental complexity; leaky abstractions, tech debt, and technical decisions made before your time.

I've written before how writing software is more of an artisan process than a construction process. And it is because this is still a young immature industry, despite how large and monied it is. We're still learning how to do this. Humans have been constructing buildings for thousands of years, we've figured out a few things and standardized on nearly everything. That said, there are still leaky abstractions and technical debt in construction.

I live in a house constructed in 1905. This has taught me a lot. Nothing is square, level, or plumb. That said, if you've ever walked into new construction—nothing is square level or plumb there either. Over that time there have been decisions and bad work. As an unskilled construction worker I can get by fixing things in this house. But the true expert, the master of their craft in construction and carpentry, can walk in here and produce work that results in perfection despite what is underneath.

We aren't close in the tech to allowing unskilled workers to make real progress. Hell, we're still trying to help ourselves.

Most of the startups that cater to other developers are working to eliminate accidental complexity for others by taking it on themselves and asking folks to pay for it. Many open source projects, I'm looking at you Kubernetes, are designed explicitly for removing this accidental complexity. To band together and try to make managing all the servers in a data center look like managing a single server. You can only reason about things that can fit inside your head. K8s is an operational metaphor that tries to get everything into your head so you can reason about it.

I look at Lambdas, and messaging services (whether it's AMPQ or Kafka), and I see the attempt to make a distributed system made up dozens of CPUs and hundreds of gigs of memory operate as if it was on one system. By making servers "not matter" you can think about your running application as a logic puzzle that runs on one system.

This is not limited to system design. We do this when we architect our code as well. We create interfaces and patterns that put complexity in the one spot where it is necessary to deal with. And we attempt to wall off each different complexity from one another.

This is the trend we've been on in cloud computing—eliminating anything and everything we can that makes applications look distributed. We don't always succeed. Just like in construction nothing is level, square, or plumb. When the abstractions leak we need the experts, the master artisans.

We are trying desperately to do more with less. Fewer engineers, fewer meetings, because those are the most expensive pieces of this puzzle, the network effect born by communicating. I'm not sure we're succeeding yet, but we're trying like hell.

Read more: Layers, Complexity, and Trends

Space Required

6 Oct 2020

There is a unique failure mode that I have experienced: trying too hard. I never saw this one coming, and I never expected it. "Trying too hard" means that you have a tight grip over each aspect of every project. The biggest symptom I have experienced from this failure mode: The Bystander Effect.

"Bystander effects" are when folks on the team wait for someone to tell them what to do or to make a decision. It is a lack of initiative. The team expects the leader to do all that. And this leader doesn't have to be a manager or "the boss", it can be a fellow team member. Trying too hard can result in unexpectedly becoming a gatekeeper. Everything needs their stamp, their confirmation, their inclusion. The team learns "this is how we do things here" and waits.

If you are seeing bystander effects, and lack of initiative, the antidote is space. Space is required for people to take ownership. Space is required for people to grow. Space is required for people to make improvements, and to improve themselves.

Creating space looks like putting in guardrails and explicitly stating your expectations. However, space is not a vacuum. It will be rocky at first, and folks will say it feels like a vacuum. Stating expectations is the tool to align everyone's behavior, this is the hands-off part (e.g. give the problem, and loosely define the process). The guardrails are where you want the team to include you in the process again. That can be varied based on your situation and may include: "if the solution will cost more than $X", "if the solution will take longer than Y", or when there are multiple teams and boundaries involved "if the solution requires changes to interfaces or APIs that other teams manage".

A good test of whether or not your team is set up for success and owning their own work is: can you go on a two week vacation and when you return you see progress.

Read more: Space Required