William Bratz | Writing https://www.williambratz.com/blog Essays on production AI systems, distributed software, engineering judgment, and organizational knowledge. en-us Mon, 27 Jul 2026 00:00:00 GMT When the Map Starts Learning: Building a Shared Memory for Humans and AI https://www.williambratz.com/blog/bridging-the-gap https://www.williambratz.com/blog/bridging-the-gap Mon, 27 Jul 2026 00:00:00 GMT What happens when documentation stops being a destination and becomes living context for product, engineering, and AI. The Map Is Not the Theory: Why Docs and Diagrams Will Mislead You https://www.williambratz.com/blog/the-map-is-not-the-theory https://www.williambratz.com/blog/the-map-is-not-the-theory Sat, 09 Aug 2025 00:00:00 GMT Written artifacts are just approximations; the real system lives in the team's head. Programming as Theory Building: Why "Just Read the Docs" (RTFM) Never Works https://www.williambratz.com/blog/programming-as-theory-building https://www.williambratz.com/blog/programming-as-theory-building Sat, 02 Aug 2025 00:00:00 GMT Why understanding code requires more than documentation alone. Railway-Oriented Programming in C#: Errors Without the Spaghetti https://www.williambratz.com/blog/railway-oriented-programming https://www.williambratz.com/blog/railway-oriented-programming Thu, 12 Jun 2025 00:00:00 GMT A practical guide to Railway-Oriented Programming in C#, with real examples for keeping error-handling logic explicit and composable. Understanding Authorization: A Practical Guide https://www.williambratz.com/blog/auth-intro https://www.williambratz.com/blog/auth-intro Wed, 26 Apr 2023 00:00:00 GMT A practical introduction to authorization, access control, and the core decisions behind protecting application resources. A Factory Pattern for Simpler Object Creation https://www.williambratz.com/blog/favorite-factory https://www.williambratz.com/blog/favorite-factory Tue, 25 Oct 2022 00:00:00 GMT A C# factory pattern that reduces repeated object-creation logic while keeping concrete types and parameters easy to extend. The Only 8 Git Commands You'll Ever Need https://www.williambratz.com/blog/only-git-commands-youll-ever-need https://www.williambratz.com/blog/only-git-commands-youll-ever-need Wed, 30 Dec 2020 00:00:00 GMT Eight Git commands that cover most daily work, plus a few tools and setup choices that make the command line easier to live in. Extension Methods, Fluent Interfaces, and Method Chaining in C# https://www.williambratz.com/blog/fluent-interfaces https://www.williambratz.com/blog/fluent-interfaces Mon, 14 Dec 2020 00:00:00 GMT How extension methods, method chaining, and fluent interfaces can make C# code more expressive without hiding what it does. The Leap of Faith https://www.williambratz.com/blog/the-leap-of-faith https://www.williambratz.com/blog/the-leap-of-faith Sat, 05 Dec 2020 00:00:00 GMT A personal reflection on opportunity, calculated risk, and what can happen when you choose to take the leap.