Skip to content

docs: close the roadmap page's release-history gap - #1052

Merged
milkway merged 1 commit into
mainfrom
docs/roadmap-history-gap
Jul 30, 2026
Merged

docs: close the roadmap page's release-history gap#1052
milkway merged 1 commit into
mainfrom
docs/roadmap-history-gap

Conversation

@milkway

@milkway milkway commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Follow-up da #1051, encontrado ao verificar o site publicado em vez de confiar no build.

O que estava errado

A página de roadmap narra o pós-1.0 em faixas de versãov0.1.4 – v0.2.5, v0.2.6 – v0.2.13, v0.2.14 – v0.2.19 — e parou ali. O refresh da v0.2.51 acrescentou um parágrafo sem faixa, o que encobria trinta releases: um leitor sai com a impressão de que nada aconteceu entre o trabalho de imagens privadas e agora.

Três entregas reais estavam ausentes da narrativa: MFA step-up por app, o self-healing contra mudanças externas de container, e a seção Atividades. Conferi cada uma no news.md, não na memória.

O que mudou

Duas faixas novas cobrindo v0.2.20–v0.2.44 e v0.2.45–v0.2.49, mais uma correção de atribuição no parágrafo que a #1051 adicionou: ele creditava os cronjobs ao trabalho mais recente, mas eles saíram na v0.2.43 — foram para a faixa onde pertencem.

Uma decisão que vale explicar

O parágrafo final não leva faixa de versão, de propósito. Todas as opções eram ruins: fechar a faixa exigiria nomear a release atual e envelheceria na próxima; e latest ou "most recent" é precisamente a armadilha que deixou v0.2.x · latest parado no diagrama de roadmap até esta sessão, porque quem escreve não volta para atualizar. Sem faixa, o texto continua correto sozinho.

mdbook build book passa.

🤖 Generated with Claude Code

The site's roadmap narrates post-1.0 work in version bands — v0.1.4–v0.2.5,
v0.2.6–v0.2.13, v0.2.14–v0.2.19 — and then stopped. The v0.2.51 refresh
appended a paragraph with no band, which papered over thirty releases and
left a reader thinking nothing shipped between the private-image work and
now. Three things that did ship were missing entirely: step-up MFA,
self-healing against external container changes, and the Activity section.

Two bands added, checked against news.md rather than memory, plus a fix to
the new paragraph's attribution: it credited scheduled ETL jobs to the
latest work, but those shipped in v0.2.43, so they moved into the band where
they belong.

The final paragraph deliberately carries NO version band. Every candidate
was wrong or self-ageing: a closing band would have to name the current
release and go stale, and "latest"/"most recent" is exactly the trap that
left `v0.2.x · latest` sitting in the roadmap diagram until this session.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@milkway
milkway merged commit 705222f into main Jul 30, 2026
4 checks passed
@milkway
milkway deleted the docs/roadmap-history-gap branch July 30, 2026 01:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant