https://codenotes.ca/ Essays on building software inside large organizations: architecture, modernization, delivery, and the engineering leadership that holds it together. en Sat, 05 Sep 2026 00:00:00 GMT https://codenotes.ca/essays/y2k-reconsidered/ https://codenotes.ca/essays/y2k-reconsidered/ Sat, 05 Sep 2026 00:00:00 GMT The disaster that did not happen is remembered as a panic that was wrong. The record says otherwise, and the difference matters for every deadline since. Code, Noted https://codenotes.ca/essays/on-the-colour-of-the-bikeshed/ https://codenotes.ca/essays/on-the-colour-of-the-bikeshed/ Wed, 02 Sep 2026 00:00:00 GMT Parkinson's law of triviality is from 1957; the email that renamed it for software is from 1999. Both are quoted weekly and obeyed nowhere. On attention, consequence, and a budget for reviews. Code, Noted https://codenotes.ca/essays/measuring-the-bus-factor/ https://codenotes.ca/essays/measuring-the-bus-factor/ Sat, 29 Aug 2026 00:00:00 GMT Knowledge concentration can be measured from the repository itself, and researchers have been doing it for a decade. On the number nobody computes until the resignation. Code, Noted https://codenotes.ca/essays/on-the-monthly-availability-report/ https://codenotes.ca/essays/on-the-monthly-availability-report/ Sun, 23 Aug 2026 00:00:00 GMT GitHub's July report lists eight incidents, and seven of them were changes and expiries rather than code. A note on the institution of publishing your own ledger. Code, Noted https://codenotes.ca/essays/ariane-at-thirty/ https://codenotes.ca/essays/ariane-at-thirty/ Sat, 22 Aug 2026 00:00:00 GMT The most expensive integer overflow in history is now three decades old. Its lesson was never about the cast. Code, Noted https://codenotes.ca/essays/on-finally-reading-the-mainframe/ https://codenotes.ca/essays/on-finally-reading-the-mainframe/ Thu, 20 Aug 2026 00:00:00 GMT AI made forty-year-old COBOL cheap to read at last. Comprehension and migration remain different problems, and the industry keeps buying one as the other. Code, Noted https://codenotes.ca/essays/the-formats-that-outlive-us/ https://codenotes.ca/essays/the-formats-that-outlive-us/ Wed, 19 Aug 2026 00:00:00 GMT CSV never got better and never went away; Parquet is a teenager and load-bearing. An essay on file formats as the longest contracts in computing. Code, Noted https://codenotes.ca/essays/ten-hours-without-ci/ https://codenotes.ca/essays/ten-hours-without-ci/ Mon, 10 Aug 2026 00:00:00 GMT GitHub Actions failed for ten hours and forty-two minutes on August 6. Read as an instrument, the outage measured every pipeline that runs through it. Code, Noted https://codenotes.ca/essays/what-the-mainframes-survival-teaches/ https://codenotes.ca/essays/what-the-mainframes-survival-teaches/ Fri, 07 Aug 2026 00:00:00 GMT Six decades after System/360, the machine every strategy deck kills is still clearing the payments. A long essay on why, and what its persistence actually indicts. Code, Noted https://codenotes.ca/essays/what-the-cyber-resilience-act-asks/ https://codenotes.ca/essays/what-the-cyber-resilience-act-asks/ Wed, 05 Aug 2026 00:00:00 GMT From September 11 the CRA's reporting clocks start at 24 hours. The obligation is written for manufacturers, but the capability it requires is built by engineers. Code, Noted https://codenotes.ca/essays/on-the-engineering-memoir/ https://codenotes.ca/essays/on-the-engineering-memoir/ Thu, 30 Jul 2026 00:00:00 GMT A quiet genre is doing documentation's best work: the practitioner explaining, in public, how their own system actually works. Notes toward taking it seriously. Code, Noted https://codenotes.ca/essays/the-homelab-argument/ https://codenotes.ca/essays/the-homelab-argument/ Thu, 16 Jul 2026 00:00:00 GMT The strongest case for running servers in a closet has nothing to do with the servers. A long essay on small systems as professional education. Code, Noted https://codenotes.ca/essays/the-quiet-quarter/ https://codenotes.ca/essays/the-quiet-quarter/ Thu, 02 Jul 2026 00:00:00 GMT No incidents, no migrations, no launches. A short argument that the uneventful quarter is an engineering artifact, and that someone built it. Code, Noted https://codenotes.ca/essays/confidence-is-not-a-permission-system/ https://codenotes.ca/essays/confidence-is-not-a-permission-system/ Mon, 08 Jun 2026 00:00:00 GMT Automated systems have always failed by choosing the wrong rule with conviction. An essay on authority design, from Therac-25 to the agent on your estate. Code, Noted https://codenotes.ca/essays/best-practice-has-an-expiry-date/ https://codenotes.ca/essays/best-practice-has-an-expiry-date/ Mon, 25 May 2026 00:00:00 GMT Microservices were mandatory in 2016 and apologized for by 2023. An essay on why engineering wisdom decays, and how to date a practice before adopting it. Code, Noted https://codenotes.ca/essays/engineering-ladders-and-load/ https://codenotes.ca/essays/engineering-ladders-and-load/ Thu, 30 Apr 2026 00:00:00 GMT Career ladders are load-bearing structures. What an organization promotes for is what its systems will eventually be made of. Code, Noted https://codenotes.ca/essays/the-audit-that-found-the-architecture/ https://codenotes.ca/essays/the-audit-that-found-the-architecture/ Sun, 19 Apr 2026 00:00:00 GMT Sometimes the truest system diagram is produced by outsiders with a checklist. Why audits see what architects stopped seeing, and how to borrow the trick. Code, Noted https://codenotes.ca/essays/the-meeting-that-replaced-the-design-doc/ https://codenotes.ca/essays/the-meeting-that-replaced-the-design-doc/ Fri, 17 Apr 2026 00:00:00 GMT Organizations drift from written design to verbal consensus one calendar invite at a time. What the written form was doing, and how to notice it going. Code, Noted https://codenotes.ca/essays/what-a-service-boundary-is-for/ https://codenotes.ca/essays/what-a-service-boundary-is-for/ Fri, 27 Mar 2026 00:00:00 GMT Before arguing about microservices it helps to ask what a boundary buys you. The answer was written down in 1972 and has not changed. Code, Noted https://codenotes.ca/essays/enterprise-ai-is-an-integration-problem/ https://codenotes.ca/essays/enterprise-ai-is-an-integration-problem/ Tue, 03 Mar 2026 00:00:00 GMT The model is the easy part. Enterprise AI succeeds or fails on the same unglamorous surfaces as every prior integration wave. Code, Noted