System Language

The Language of the System by Rick Hickey is an illuminating talk about why systems differ from programs. It provides a clear framework for understanding and addressing the differences. I believe these same ideas underpin some of the recent movements in software design philosophy. Let’s explore.

September 4, 2020 · 6 min

Chat Library Case Study: Open-Closed Application

This is a throw back to one of my earlier wrestlings with the Open-Closed principle and writing extensible frameworks. The goal is to shed some light on an important realization that let me to understanding the Open-Closed Principle.

August 28, 2020 · 4 min

Test Api In Practice

A friend of mine, Paul Spoon, wrote a delightful article about using the Anti-Corruption Layer pattern as a tool for more stable tests. I tried the pattern with skepticism, and will now never go back. Let’s take a brief look at the pattern then dive into the benefits I’ve experienced.

August 21, 2020 · 6 min

Notification Refactor Case Study

A general design for integrating notifications (email, text, push, etc) has long eluded me. However, a recent refactor using the concepts of Synthesizing Project Organization Methods has settled my search. Here I’ll explore my refactoring experience and why the conceptual shift is generically more stable.

August 14, 2020 · 7 min

Why Static Structs are Better Than Enums

C# (and Java) offer a type call enum (aka enumeration). It represents a fixed list of possible values and is a powerful tool for communicating intentions through the type system. However, a recent legacy project forced me to face the shortcomings of enums and realize an even more powerful pattern, struct named constants.

August 7, 2020 · 6 min

Rediscovering Options - Design Matrix

I got to thinking about the Rediscovering Options post. The volatility analysis portion is an important artifact of my design process. The current version requires reading the whole list to comprehend the results. How could I make it better?

July 31, 2020 · 5 min

Rediscovering Options

Configuration is a powerful tool and a dangerous temptation. My goal in this post is to walk through the ways I mishandled configuration, ended up rediscovering the Options configuration pattern, and finally dive into specific design scenarios to show why Options is the most stable solution.

July 24, 2020 · 10 min

Righting Software - Project Design Summary

Part 2 of Righting software presents the most complete theory of project management I’ve seen: the Critical Path Method.

July 16, 2020 · 12 min

Synthesizing Project Organization Methods

How to organize code into projects/packages can be a challenge. Here’s an interesting idea I thought of from synthesizing ideas from Robert Martin, Juval Lowy, Mark Seemann, and how many nuget packages are organized.

July 10, 2020 · 3 min

Righting Software Visual Summary

Thus far this only includes the System Design portion of the book.

July 3, 2020 · 2 min