blog: what a good install actually is (installation norms essay) - #9
Merged
Merged
Conversation
Replace announcement voice with an inner-thought essay on installation norms, Windows requirement sets, UIL dual-mode, and shell-visible layout. Co-authored-by: Ryan Johnson <AMDphreak@users.noreply.github.com>
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Documentation automation assessment
Docs added/updated (pushed to this branch)
- Antora changelog index entry 2026-09-18 — Installation craft essay plus detail page
docs/modules/devcentr-org/pages/changelog-details/2026-09-18 - installation-craft-essay.adoc. - Root
CHANGELOG.adocmirror bullet for the same release.
Codepaths covered
- Authored news pipeline:
content/news/2026-09-18-what-a-good-install-actually-is.adoc→pnpm news:build→src/lib/news-posts.generated.json, RSS/Atom. - Public route
/news/2026-09-18-what-a-good-install-actually-is(and/blogalias). - Cross-links to general-knowledge installation cluster, Ibex docs, Install Coordinator, OpenShellOrg, connectome-fs, and prior MSI queue essay.
Gaps addressed
- Shipping record for the essay now lives in Antora changelog (per
news-and-changelog.adoc— news narrative stays out of changelog bullets inside the post). - README and Antora site wiring unchanged; already meet org standards.
Residual risk
- Four
docs.devcentr.org/general-knowledge/.../installation/...targets still return 404 at review time. The preamble honestly frames GK as in progress; consider merging only after publish or adding a short “when live” qualifier near the deep links (see inline).
Voice / structure
- Title fits inward essay stance;
:keywords:includesblogfor SEO; MSI callback to Aug 2026 news is a strong internal link.
Sent by Cursor Automation: Generate docs
| Good craft here looks like **well-known entrypoint names**, **versioned install roots**, and **environment mutation you can enumerate**. | ||
| Bad craft looks like "we picked `/usr/local/bin` because the README said so" with no story for Nix users, container bind mounts, or a user who cannot sudo. | ||
|
|
||
| The encyclopedia cluster under link:https://docs.devcentr.org/general-knowledge/explanation/architecture/installation/[installation architecture] names patterns and anti-patterns so authors stop re-deriving this thread from first principles on every new tool. |
There was a problem hiding this comment.
Docs automation checked these URLs on 2026-09-18 — the installation architecture hub and the UIL / norms / good-vs-bad detail pages under general-knowledge all return 404 on docs.devcentr.org today.
Line 16 already says the guide is being written into GK; readers who jump straight to this link may hit a dead end. Options before merge: publish the GK cluster, temporarily point at a staging URL, or add one clause here (“links go live with the GK rollout”).
| I keep coming back to installs because they are where philosophy meets disk: what you claim to own, what you leave reversible, and what a shell—or a graph store five years from now—can still find without archaeology. | ||
|
|
||
| This essay is not a shipping notice. | ||
| It is the craft frame behind an installation norms guide and a layout proposal (UIL) we are writing into general-knowledge. |
There was a problem hiding this comment.
Nice alignment with content/news/README.adoc: outward shipping stays on /changelog, while this piece reads as inward craft — the “not a shipping notice” beat makes that explicit for feed readers.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Replaces the closed #8 announcement approach with a blog-voice essay (inner thought / craft / philosophy), per the news README stance: blog = ideas and craft, not “we shipped.”
Post
content/news/2026-09-18-what-a-good-install-actually-is.adocblog(no announcement framing)/news/2026-09-18-what-a-good-install-actually-is(also/blog/…)Covers installation norms as craft: FHS cargo-cult, Windows direct-to-disk as a requirement set, Linux variance, UIL dual-mode (classic + connectome-fs), OpenShellOrg shell visibility, Install Coordinator + Ibex as tooling hypotheses, with links to the general-knowledge installation cluster.
Not included
2026-09-18-installation-norms-and-uil.adocannouncement post (PR news: installation norms guide and UIL proposal #8 was closed unmerged).Build
pnpm run news:build— catalog + RSS/Atom updated