One of my favorite engineering things to do is to look at a system, squint a little, and go "If we move this piece over there, everything becomes easier".
We had a good opportunity for that at work recently.
A rethink can go a long way
My team took over a system for support groups where you can sign up for N sessions with a class. It was about to launch and things were going wrong.
The previous team built a system based on an hourly cron-job: Checks what you're signed up for and adds appointments to your schedule about a week in advance. But only if you've already had the latest appointment so far.
Yes, it was difficult to test and debug. Lots of moving pieces and state that has to be juuuust right.
What's worse, the system had trouble enforcing max group capacity – couldn't reliably count how many people are signed up for a group because appointments didn't exist yet. Wanna cancel your appointment? Wait until it shows up. Bail out of the whole series? Nope, you're stuck with us.
We looked at the flaming hot potato, squinted, and said "If we create all your appointments as soon as you sign up, all these problems just ... disappear."
So that's what we did. In about a week, we rearchitected the system and that:
- made it trivial to test and debug – no moving pieces
- made cancelling appointments trivial – existing feature works
- made bailing from a group trivial – cancel all appointments
- made enforcing capacity trivial –
count(distinct patient) from appointments
Great success yeah?
You need the right attitude
Spotting those opportunities comes down to attitude, I think. Best described through the brick layer parable.
You come upon 3 bricklayers, ask them what they're doing, and get 3 responses.
- I'm laying bricks
- I'm building a wall
- I'm building a cathedral
The first bricklayer is the engineer who's a diligent worker, does what they're told, and executes. Picks jira tickets off the board and gets them done few questions asked. They're a great pair of hands, but not a brain.
The second bricklayer is that engineer who is lovely to work with. They'll ask just enough questions to keep you honest, help you clarify requirements for a story, and can make a great partner to the right product owner.
The third bricklayer is that engineer who companies rush to hire. They focus on user outcomes and will rip requirements to shreds until they find the simplest possible system that gets the job done. Looking 5 steps ahead this engineer is on an equal footing with the product owner, a true partner. We're building a cathedral, do we really need this wall?
Yes, this engineer is insufferable to the wrong product owner :)
Focus on the goal
When designing systems and writing code, focus on what you're trying to achieve. Not just the current task at hand.
No amount of clever hackery can save you from building the wrong thing.
Cheers,
~Swizec
Continue reading about Own the outcome, not the work
Semantically similar articles hand-picked by GPT-4
- You can't stop the business, or why rewrites fail
- Solve the problem, not a different more difficult problem
- What's more productive, a team or a talented soloist?
- Architecture is like a path in the woods
- The code is not the goal
Become a *true* Senior Engineer
Get promoted, earn a bigger salary, work for top companies
Getting that senior title is easy. Just stick around. Being a true senior takes a new way of thinking. Do you have it?
The Senior Minset email crash course
Get a free chapter from the Senior Engineer Mindset book and a sample audiobook chapter, followed by a Senior Mindset 101 email course.
You'll get insights to apply at your work right away.
Have a burning question that you think I can answer? Hit me up on twitter and I'll do my best.
Who am I and who do I help? I'm Swizec Teller and I turn coders into engineers with "Raw and honest from the heart!" writing. No bullshit. Real insights into the career and skills of a modern software engineer.
Want to become a true senior engineer? Take ownership, have autonomy, and be a force multiplier on your team. The Senior Engineer Mindset ebook can help 👉 swizec.com/senior-mindset. These are the shifts in mindset that unlocked my career.
Curious about Serverless and the modern backend? Check out Serverless Handbook, for frontend engineers 👉 ServerlessHandbook.dev
Want to Stop copy pasting D3 examples and create data visualizations of your own? Learn how to build scalable dataviz React components your whole team can understand with React for Data Visualization
Want to get my best emails on JavaScript, React, Serverless, Fullstack Web, or Indie Hacking? Check out swizec.com/collections
Did someone amazing share this letter with you? Wonderful! You can sign up for my weekly letters for software engineers on their path to greatness, here: swizec.com/blog
Want to brush up on your modern JavaScript syntax? Check out my interactive cheatsheet: es6cheatsheet.com
By the way, just in case no one has told you it yet today: I love and appreciate you for who you are ❤️