API Design

The Caching Layer

A junior added a cache to speed up the slow endpoint. The endpoint was fast. The data was wrong. The senior developer asked, “Did the cache work?” “It did exactly what I asked it to.” “And was that what you wanted?” The Code Behind the Koan Almost every caching incident starts with a correctly implemented […]

The Breaking Change

A developer updated a library, breaking dependent applications. Users complained loudly. The senior developer asked, “If the change improves the library, what does it break besides the code?” And then, “When something breaks, what was it depending on that you didn’t see?” Sitting with the Koan When we speak of breaking changes, we typically frame […]