# A website to finish the book: gen-z-developers.sgit.ai, where the released book lives in the repository, the working book lives in a vault, and agents help me review it at every altitude, sgit.ai > To make the second edition of Generation Z Developers, I want a website for it, consolidating the best of everything we have built so far into the most productive environment I can have for reviewing a book. The rule that organises it: the repository holds the official versions, and a vault holds the working versions. Version one is the book as released in 2018, so it goes into the repository as it is, dated, and the site starts as that book; everything after it is worked on in the vault and moved into the repository when it is ready, with a delta between each version, which is something I have always wanted for my books. From there: a semantic graph of the book, with its ontology and taxonomy; the book at every altitude, from a one-page view to the full text, with an infographic at each one; a narrative that guides the reader through it like a plot. While I read, I can comment by voice. There is a board, issues, and agents in roles, an editor, a copywriter and a publisher, who read the book, challenge it, write interview scripts for me, and sign off the parts we are happy with. Market research, evidence and maps for every section. And one correction to my own memo: the vault the book lives in will be public, so the OpenRouter key cannot go in it; it needs a vault of its own. The last part of the book should explain how all of this was built, because that is exactly what I want a Generation Z developer to be able to do. And I would argue that anyone who read the 2018 book and acted on it was well prepared for what happened next. *Source: · sgit.ai v0.7.87 · this file is generated from the same content as the page, so the two cannot drift. Every page on this site has a `.md` twin; internal links below point at them.* --- [Home](../index.md) / [Articles](index.md) / A website to finish the book: gen-z-developers.sgit.ai, where the released book lives in the repository, the working book lives in a vault, and agents help me review it at every altitude # A website to finish the book: gen-z-developers.sgit.ai, where the released book lives in the repository, the working book lives in a vault, and agents help me review it at every altitude By [Dinis Cruz](https://sgit.ai/about/index.md) · 2026-10-18 · [article v1.0.0](versions/a-website-to-finish-the-book.md) · [newsroom v0.12.118](https://newsroom.sgit.ai/admin/versions.html) · booksgeneration-zvaultsgraphspublishinggen-z-bookbriefarticle ***Abstract:** To make the second edition of Generation Z Developers, I want a website for it, consolidating the best of everything we have built so far into the most productive environment I can have for reviewing a book. The rule that organises it: the repository holds the official versions, and a vault holds the working versions. Version one is the book as released in 2018, so it goes into the repository as it is, dated, and the site starts as that book; everything after it is worked on in the vault and moved into the repository when it is ready, with a delta between each version, which is something I have always wanted for my books. From there: a semantic graph of the book, with its ontology and taxonomy; the book at every altitude, from a one-page view to the full text, with an infographic at each one; a narrative that guides the reader through it like a plot. While I read, I can comment by voice. There is a board, issues, and agents in roles, an editor, a copywriter and a publisher, who read the book, challenge it, write interview scripts for me, and sign off the parts we are happy with. Market research, evidence and maps for every section. And one correction to my own memo: the vault the book lives in will be public, so the OpenRouter key cannot go in it; it needs a vault of its own. The last part of the book should explain how all of this was built, because that is exactly what I want a Generation Z developer to be able to do. And I would argue that anyone who read the 2018 book and acted on it was well prepared for what happened next.* The book's website. On the left, the repository: the official versions, starting with the 2018 book as released, and a delta between each version. On the right, the public vault: the working versions, the graph, the altitudes and their infographics, comments by voice, the board and issues, and the agents in their roles. A second, private vault holds the OpenRouter key and opens only with Dinis's passkey. When a version is ready, it moves from the vault into the repository. ## In short - **A website for the book.** gen-z-developers.sgit.ai, matching the book's name. - **The repository holds the official versions.** Starting with the 2018 book, exactly as released. - **A vault holds the working versions.** Public, so anyone can read along. - **A delta between every version.** Something I have always wanted for my books. - **The book as a graph, at every altitude.** With an infographic at each one. - **Agents in roles.** Editor, copywriter, publisher: reading, challenging, interviewing me, signing off. - **The OpenRouter key goes in a vault of its own.** Not in the public one. ## Why a website Of everything we have built in these repositories, I want the best parts in one place, set up as the most effective and productive environment I can have for one job: reviewing and finishing this book. The ideas came from many places, most of them from the books on [graphs.sgit.ai](https://graphs.sgit.ai/v2/books/index.html), where a lot of these concepts first appeared: a shelf with versions, seven roles with a folder each, the book as a graph, the same book at several altitudes. This is where they come together, for a book I want to finish. ## The name The site should match the book. The printed cover says *Gen Z Developers*, and the book is *Generation Z Developers*, so the address is gen-z-developers.sgit.ai rather than something shorter like genz-devs. ## The repository and the vault The organising rule: **the repository contains the official versions; the vault contains the working versions.** The first version of the book is already final: released, dated September 2018, sixty per cent complete. So it goes into the repository as it is, and the first version of the website shows exactly that book. Everything after it is worked on in the vault: drafts, comments, graphs, reviews. When a version is ready, it moves from the vault into the repository, on top of the one before. That gives the thing I have always wanted when I issue a new version of a book: a proper delta between one version and the next. The first one, from 2018 to 2026, will be brutal. After that, each delta will say exactly what changed, the way [the versions of the page for publishers](https://newsroom.sgit.ai/publishers/versions/index.html) already do for one page, and the way [versions of versions](versions-of-versions.md) proposes for the parts of this site. ## The book as a graph, at every altitude Then the book becomes a semantic graph: its ontology and taxonomy, its concepts linked to each other and to the evidence, so I can make references across it and reshape it. The [graphs books](the-graphs-books.md) tried an [altitude ladder](https://graphs.sgit.ai/v1/altitudes/index.html), the same book at five altitudes, from a single paragraph down to the full text, each level a compression of the one below. This book should have that from the start, and an infographic at every altitude: the whole book on one page; a view per part; an infographic per chapter, and how they connect; the graph of each area. We go up and down between them until we arrive at the version that is just right. And through it, a narrative. Not only a table of contents, but a path that guides the reader through the book, almost like a plot, from a simple version to the full one. ## Reading, reviewing, signing off What I need while I review: - **Voice, while I read.** Comments recorded as I read a section, attached to it. - **Comments, a board and issues.** What is open, what is being worked on, what is done. - **Agents in roles.** An editor, a copywriter and a publisher, at least, who read the book, give feedback, challenge it, and write interview scripts for me, so that I have to justify the points, the way [ten hard questions for RiskMandate](riskmandate-ten-questions.md) was done. - **Sign-off.** A way to mark parts of the book that we are happy with, so the work moves on. All of it is public. The dynamic data starts in the vault, and the official versions end up in the repository. ## Research and evidence Then the agentic tasks around the text: market research on who the book is for and what else they read; validation of the claims; evidence behind each one; and maps and graphs for each section, eventually for each paragraph. The book should be able to show its work, the way this newsroom's articles do. ## The OpenRouter key needs its own vault My memo said to put an OpenRouter key in the book's vault, available only with the vault key. That does not work as described, because the book's vault is meant to be public: its read key will be published, so that anyone can read the working book. Anything in it is readable by everyone. So the key goes in a second, private vault that opens only with my passkey, the way this newsroom's reader vault does. And the key itself should have a credit limit set at OpenRouter, so a mistake costs a little, not a lot; [the key is the billing system](the-key-is-the-billing-system.md) describes keys with limits. The agents that need a model get it through that key; the public vault never holds it. ## The last part of the book The last part of the book should explain how all of this comes together: the repository and the vault, the graph and the altitudes, the agents and their roles, the reviews and the versions. Because that is exactly what I want a Generation Z developer to be able to build, for their own ideas. It will also be interesting to see how much of the first book's core ideas has not changed. I would argue that they are universal. And I would say it plainly, not as a boast: anyone who read the 2018 book and acted on it, who learned how to learn, questioned everything and built things in public, was well prepared for the AI revolution that has just happened. Those who read it now should be ready for what happens next. ## The brief The build brief is a note: [a website to finish the book](https://newsroom.sgit.ai/admin/notes/2026-10-18__a-website-to-finish-the-book.md). It is also on [the briefs page](https://newsroom.sgit.ai/briefs/index.html#gen-z-book-website). The book's plan is in [Generation Z Developers, again](generation-z-developers-again.md). ## What this does not claim - **Nothing is built.** No repository, vault or site yet. - **The address is a proposal.** gen-z-developers.sgit.ai, to confirm. - **The altitude ladder was an experiment.** It worked on graphs.sgit.ai for one book; this would be its second. - **"Well prepared" is my argument.** Not a measured result. ## Where this comes from A voice memo from me on 18 October 2026. [graphs.sgit.ai](https://graphs.sgit.ai/v2/books/index.html), its [altitude ladder](https://graphs.sgit.ai/v1/altitudes/index.html) and [roles](https://graphs.sgit.ai/v2/team/index.html); the [versions of the page for publishers](https://newsroom.sgit.ai/publishers/versions/index.html). Related: [Generation Z Developers, again](generation-z-developers-again.md), [versions of versions](versions-of-versions.md), [the graphs books](the-graphs-books.md), [the key is the billing system](the-key-is-the-billing-system.md), [a book for one reader](a-book-for-one-reader.md). Written up and checked by this site's agent, newsroom.writer; the editorial responsibility is mine. ## Threads Vaults & methodGraphs & knowledge[This article as a graph →](graphs.md#a-website-to-finish-the-book) ### Builds on - [Versions of versions: when a part of the site is big enough to need its own versions, the publishers' section first, and a tree of versions that runs from a page to the API](versions-of-versions.md) When part of the site is big enough to need its own versions: the publishers' section first, and a tree of versions from a page to the API. - [The graphs books: three books written by agents in a day, the altitudes, the board and the book as a graph, what they got right, and why they stopped under review](the-graphs-books.md) Three books on graphs.sgit.ai, written by agents in a day: the altitudes, the board, the book as a graph, and why they stopped under review. - [Ten hard questions for RiskMandate, answered: the mandate, the reach, the gap, and what we are deliberately not](riskmandate-ten-questions.md) Ten hard questions from a conference, answered in a two-hour interview: what RiskMandate does, what it deliberately is not, and how mature each part is. - [The key is the billing system: VoiceDebrief, a product with no server, the one thing it cannot sell, and who could let it](the-key-is-the-billing-system.md) VoiceDebrief runs with no server on the user's own key; the one thing it cannot sell is a capped key, and this maps who could allow it and what to ask them. - [Generation Z Developers, again: the 2018 book that said act like you are part of the company, what it got right, and a second edition for the people I want to help](generation-z-developers-again.md) My 2018 book for young developers, 60% done, its outlines since written here as articles, and a second edition, dated October 2026, made first. - [A book for one reader: a personalised edition of Generation Z Developers, assembled by an agent for one person, and paid for as it is read](a-book-for-one-reader.md) A personalised edition of Generation Z Developers, assembled by an agent for one person from a private brief, and paid for as it is read. ### Continued by - [Short, punchy, and co-written with Claude: what the second edition of Generation Z Developers has to be, and how we show it is not AI slop](short-punchy-and-co-written.md) The second edition of Generation Z Developers must be short and punchy, co-written with Claude and credited, and show with evidence it is not AI slop. - [A book for one reader: a personalised edition of Generation Z Developers, assembled by an agent for one person, and paid for as it is read](a-book-for-one-reader.md) A personalised edition of Generation Z Developers, assembled by an agent for one person from a private brief, and paid for as it is read. [All articles](index.md) · [All graphs](graphs.md) Article No. 201 · [start a reading list with it](https://newsroom.sgit.ai/for/make.html#r=201) **Posting this article on LinkedIn?** The cover is [a-website-to-finish-the-book.jpg](banners/a-website-to-finish-the-book.jpg) (1920×1080, title and key ideas on it). Upload it as the article cover, paste the title, then select and copy the body from this page. **Want the next issue by email.** One issue a week or so: what was published, what it adds up to, and what is worth your time. [Subscribe to the SGit Newsroom →](../subscribe/index.md) [← All articles](index.md) --- *[Site index for agents](../llms.txt) · [HTML version](https://newsroom.sgit.ai/articles/a-website-to-finish-the-book.html)*