Hironobu Suzuki has been doing something quietly remarkable since September 2015: writing and maintaining a free, comprehensive technical documentation of PostgreSQL's internal architecture, covering everything from buffer management and WAL to streaming replication and logical replication. The work now spans 12 chapters covering versions through 19-beta, and it's cited in academic papers. The scope is genuinely ambitious for a solo effort. The table of contents reads like a graduate database systems syllabus: process and memory architecture, query processing, concurrency control, VACUUM, HOT and index-only scans, buffer manager, WAL, backup and PITR, streaming replication, and the newly published logical replication chapter. Each of these topics is a rabbit hole that could consume an entire book, and Suzuki treats them all with the kind of diagram-heavy, mechanism-first explanation style that makes internals accessible to working engineers. What makes this unusual is the authorial model. This is not a community wiki, not a corporate documentation effort, not a book published through O'Reilly. It's one person's HTML site, maintained on their own server, updated on their own schedule. Suzuki is explicit about this: he doesn't want contributors, doesn't want to use GitBook, doesn't plan PDF or mobile versions, and doesn't use RSS. The FAQ is delightfully blunt about all of it. The update cadence tells its own story. The most recent additions — asynchronous I/O coverage in June 2026 and logical replication in May 2026 — show the work is actively maintained and tracking PostgreSQL's evolution. The Chinese translation published in 2019 suggests the documentation has found an international audience beyond the English-speaking PostgreSQL community. Suzuki's background gives the work credibility: an M.S. in Information Engineering, seven published database books (four PostgreSQL, three MySQL), six years directing the Japan PostgreSQL Users Group, and program committee work on the Japan PostgreSQL Conference. This isn't a weekend blogger — it's someone with decades of professional investment in the system they're documenting. The personal context is worth noting. Suzuki is currently based in Japan for health and personal reasons, seeking remote work in ML/AI applied to DBMS, and open to international opportunities with visa sponsorship. The documentation exists alongside an active career, not as a retirement project. The copyright model is interesting and slightly eccentric. Educational use is free. Commercial use requires either a 20% revenue share or a €5,000,000 full buyout — the latter presented as a joke, though the revenue share clause appears genuine. For the vast majority of readers — engineers learning PostgreSQL internals — none of this matters. The documentation is free to read, and it's the best single-author resource of its kind.
