System Design on Maceage's Blog

System Design Learnings

Fri, 30 Aug 2024 00:00:00 +0000

As a software engineer who grew up developing desktop applications before moving into web development, I spent most of my career in the depths of application code rather than infrastructure.

Hosting and networking were handled by other teams or companies – my responsibility was writing software that ran on top of that stack, not worrying about the foundation beneath it.

But that landscape has shifted. System design interviews are now ubiquitous in tech hiring, particularly at scale-focused companies. These interviews assess your ability to architect and scale systems – a skill set that’s become as crucial as coding ability itself.

Codifying Architecture: Diagrams as Code

Sun, 03 Mar 2024 00:00:00 +0000

(Originally drafted in August 2019 during my tenure at Xero. Republished here in March 2024 with updated context and removed proprietary references)

Engineers love writing code. There’s nothing quite like instantly seeing the fruits of your labour appear on a screen – immediate feedback and the joy of getting something working.

Engineers, however, tend to hate writing documentation. It takes time, it’s seen as overhead to “real work,” and so it falls by the wayside. The next engineer to come along is told: “Oh, that’s out of date – just look at the ‘self-documenting’ code instead.”

The C4 Model: From Attendee to Facilitator

Sun, 25 Feb 2024 00:00:00 +0000

(Originally drafted in December 2019 during my tenure at Xero. Republished here in February 2024 with updated context and removed proprietary references)

In late 2019, I attended a workshop at YOW! Melbourne run by Simon Brown, the creator of the C4 model. It turned out to be one of the most useful conference sessions I’ve ever been to.

What made it valuable wasn’t salesmanship – though you could be forgiven for initially wondering whether you were sitting through a pitch. Simon was excellent at explaining why the format exists, why other approaches tend to fall down, and what C4 offers compared to heavier alternatives like UML and BPMN.