1. 4 min read

    API Documentation Using Tables

    Swagger UI explains one endpoint well and the shape of a large API poorly. This post proposes a table-based format that shows resources, operations and their relationships at a glance, generated from an OpenAPI definition, with a live demo against the GitHub...

  2. 7 min read

    The Roots of Object Oriented Programming

    Polymorphism, encapsulation and inheritance are cited as the pillars of OOP, yet functional languages have them too. Alan Kay’s original idea was biological: autonomous objects that communicate only by message passing. This post traces that idea and asks why almost no modern...