Writing

Structuring a knowledge hub

Most hubs begin as a blog and stay one, which is why so many of them are unusable after year two. A stream is ordered by when you wrote something; a hub is ordered by what a reader needs. Those two orders diverge quickly.

The practical fix is to separate durable pages from dated ones early, give the durable pages stable URLs, and let the dated ones link into them.

Writing for citation

A page that gets cited is one a reader can quote precisely. That means stable headings, a visible publication date paired with a machine-readable <time> element, and a correction note when something material changes — not a silent edit.

Atlas's article layout emits both date forms and leaves room above the prose for a standfirst that states the claim.

On updating rather than rewriting

An update adds; a rewrite replaces. If a reader who bookmarked the page two years ago would be confused by what they now find, it was a rewrite, and it deserves a new URL and a pointer from the old one.

Adding your own

Create a Markdown file in content/ with layout: "article" and the front matter fields listed in content.schema.toml. The build validates those fields, so a mistyped date fails the build rather than the page.