Skip to content

docs(release): sync v0.0.22 and correct what the recent fixes made untrue - #559

Merged
aicayzer merged 1 commit into
mainfrom
docs/099-v0022
Oct 21, 2026
Merged

aicayzer merged 1 commit into
mainfrom
docs/099-v0022

Conversation

@aicayzer

@aicayzer aicayzer commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Syncs the site to Marfa v0.0.22, adds its changelog entry and corrects the sentences that the v0.0.21 and v0.0.22 fixes made untrue. It is a small correction pass: no page is rewritten and no section is added. The v0.0.21 console and contract pages were already covered by the v0.0.21 release pass.

Changes

  • Sync. src/generated/ now names v0.0.22: the release, the CLI download and the server image commands. The sync changed nothing else.
  • Changelog. A short v0.0.22 entry: a folder's first sync sends queued creates in pages.
  • Folder output examples. The push and watch lines now read the server answered N write(s) (with , creating N item(s) when the pass created items), in place of answered N, held M. The "waiting" note uses the CLI's current words.
  • Folder status. One sentence says a refused document shows as held with its reason.
  • Webhooks. One sentence says the CLI prints the secret alone on the first line, like keys create.
  • Private socket. The Deploy guide now lists attachments and bulk job status among what works without a key.
  • Stores. An upload answers 503 blob_store_unavailable while a store is stuck, and replication skips a blob whose store has not answered.
  • Railway. The Deploy table says the template runs the published release image.

Already true and left alone: CLI exit codes, the unreadable keychain, redelivery details.reason, the delivery status, the login agent and the keychain, the frontmatter type word, the first-sync plan's left count, and blob reads answering 503.

Testing

  • pnpm test (366 tests), pnpm build, pnpm build:status, pnpm types:check and .github/scripts/sync-from-marfa.test.sh pass locally.
  • The sync ran from a checkout of the v0.0.22 tag. Each changed sentence was checked against the CLI source and contract at that tag.
  • Opened the local site: every changed page answers 200, and the Changelog and Deploy pages show the new text. The other changed pages were not read in the browser; they are plain text edits that built.
  • Not run: the link check beyond the build's prerender.

Notes for reviewers

Review depth: checks only, small corrections.

  • Pull request 557 also edits the changelog and Deploy pages, so whichever merges second rebases.

Checklist

  • The title is a scoped Conventional Commit.
  • New behavior has a test that was seen failing first, or no test was needed and the reason is above.
  • Docs, comments and the contract still say what is true after this change.

@aicayzer aicayzer left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review: checks only

@aicayzer
aicayzer marked this pull request as ready for review October 21, 2026 16:50
@aicayzer
aicayzer enabled auto-merge (squash) October 21, 2026 16:50
@aicayzer
aicayzer merged commit dd8de10 into main Oct 21, 2026
6 checks passed
@aicayzer
aicayzer deleted the docs/099-v0022 branch October 21, 2026 16:53
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