From cb083b7ab85a1fa5cdc2e5a8b0cc7820d9cc85a8 Mon Sep 17 00:00:00 2001 From: Pieter Viljoen Date: Sat, 1 Aug 2026 09:51:53 -0700 Subject: [PATCH 1/2] Add the 1.0 release notes to README and HISTORY The repo is public and CI is green, so 1.0 is the first public release and both files now say what it contains. `version.json` already declared 1.0, and NBGV computes the tag from it on a dispatch from `main`. HISTORY.md replaces its placeholder with a real entry, keeping the fleet shape of a version heading and a nested list. README carries the short summary the README structure asks for, three bullets, with the full list left to HISTORY. Both state the thing a reader would otherwise assume wrongly: the site is not yet serving its public address, so 1.0 is the source and its pipeline, not the cutover. Releasing without saying that would read as the migration being finished. Adds "cutover" to cspell.json, since it now appears in the two files the spell gate actually covers. Co-Authored-By: Claude Opus 5 (1M context) --- HISTORY.md | 8 +++++++- README.md | 8 ++++++++ cspell.json | 1 + 3 files changed, 16 insertions(+), 1 deletion(-) diff --git a/HISTORY.md b/HISTORY.md index 75efab6..f2f6537 100644 --- a/HISTORY.md +++ b/HISTORY.md @@ -4,4 +4,10 @@ Pieter Viljoen's blog, and the tooling that builds, verifies, and deploys it. ## Release History -The site has not been released to its public address yet. The migration is in progress, and this file records it once the first production deploy lands. +- Version 1.0: + - First public release. The blog's content, media, URL contract, and deploy tooling are published as a repository for the first time, having previously lived inside a hosted blogging platform. + - 108 posts and 2 pages as Hugo content, in a tree that mirrors the URLs it serves, with 778 media files carried at their original bytes. + - The URL contract as committed ground truth: 328 addresses that must render, 917 that must redirect, and 778 legacy image URLs that must resolve, each verified with a live request rather than predicted. + - CI gates that contract on every pull request, alongside the doc, shell, and workflow linters, with the Hugo version pinned by checksum so a build is reproducible. + - A self-contained release bundle carrying the site, the web-server config, and the redirect maps together, so a rollback reverts the rules and the content they refer to as one unit. + - The site is not yet serving its public address. This release is the source and its pipeline, not the cutover. diff --git a/README.md b/README.md index e2ddf89..5bbf306 100644 --- a/README.md +++ b/README.md @@ -22,6 +22,14 @@ The site itself is not distributed as a package. It is built from this source an ### Release Notes +**Version: 1.0**: + +**Summary**: + +- First public release. The content, media, URL contract, and deploy tooling are published as a repository for the first time. +- The URL contract is committed ground truth and gated in CI: 328 addresses that must render, 917 that must redirect, and 778 legacy image URLs that must resolve. +- The site is not yet serving its public address. This release is the source and its pipeline, not the cutover. + See [Release History][history] for the full history. ## Table of Contents diff --git a/cspell.json b/cspell.json index 91f6762..3c40073 100644 --- a/cspell.json +++ b/cspell.json @@ -21,6 +21,7 @@ "brotli", "caddyfile", "codegen", + "cutover", "dependabot", "goldmark", "insanegenius", From 486ae6e1354a114091053c78015e6016ba966aaa Mon Sep 17 00:00:00 2001 From: Pieter Viljoen Date: Sat, 1 Aug 2026 10:03:21 -0700 Subject: [PATCH 2/2] Move the version label's colon outside the bold text The line read `**Version: 1.0**:`, with a colon inside the bold and another after it, which renders as a double colon. The sibling line `**Summary**:` already puts the colon outside, so the two were inconsistent with each other as well. Now `**Version**: 1.0`, matching the sibling and the plain `Version 1.0:` form used in HISTORY.md. Raised by Copilot on this pull request. The construction was inherited from the hub's own README, which carries the same double colon, and spec/readme-structure.md does not mandate that literal form, asking only for the current version and a short summary. README.md is repo-owned, so this is fixed here and reported upstream rather than worked around. Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5bbf306..6a63ab8 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ The site itself is not distributed as a package. It is built from this source an ### Release Notes -**Version: 1.0**: +**Version**: 1.0 **Summary**: