Skip to content

docs: weekly update — 2026-08-01 - #124

Draft
dobby-coder[bot] wants to merge 2 commits into
mainfrom
docs/weekly-update-2026-08-01
Draft

docs: weekly update — 2026-08-01#124
dobby-coder[bot] wants to merge 2 commits into
mainfrom
docs/weekly-update-2026-08-01

Conversation

@dobby-coder

@dobby-coder dobby-coder Bot commented Aug 1, 2026

Copy link
Copy Markdown
Contributor

Weekly docs drift pass over what merged in encryption4all since 2026-07-25. Two things landed that the docs got wrong, both verified against the source rather than the PR descriptions.

postguard-js: the notify validator that was removed

docs/sdk/js-encryption.md said the SDK validates the notify shape and throws TypeError on { notify: true }. It does not. The only TypeErrors in packages/pg-js/src/sealed.ts are the two ReadableStream guards, and the test suite pins the validator's removal. The real behaviour is quieter and worse: delivery?.recipients on a boolean is undefined, notifyRecipients falls back to false, no mail is sent, and because opts?.notify !== undefined the one-time silent-upload notice is suppressed too. The page now says that and points at { notify: { recipients: true } }.

Source: encryption4all/postguard-js#151, which fixed the same claim in the examples' READMEs.

Repository consolidation

Four repositories were folded into the postguard-js pnpm workspace and archived, and Cryptify's source moved into the postguard Cargo workspace. The repo pages still linked to the archived repositories as the place the code lives. Archived repos keep serving files with 200, so nothing was visibly broken, only wrong.

Was Is now Source PR
postguard-js (single package) pnpm workspace, SDK at packages/pg-js encryption4all/postguard-js#132
postguard-website apps/website encryption4all/postguard-js#134
postguard-tb-addon apps/tb-addon encryption4all/postguard-js#137
postguard-outlook-addon apps/outlook-addon encryption4all/postguard-js#141, and encryption4all/postguard-outlook-addon#134 stopped publishing images from the old repo
postguard-examples examples/*, on the workspace SDK encryption4all/postguard-js#145
cryptify (own lockfile) cryptify/ in the postguard workspace encryption4all/postguard#277

Changed: docs/repos/overview.md (tables, the dependency graph, and a note on why one lockfile matters for the container header), the header lines of the seven moved project pages plus cryptify.md, and CLAUDE.md's snippet source list.

Cryptify is the one that is half-moved on purpose: the source is a workspace member, but the cryptify repository still builds and pushes ghcr.io/encryption4all/cryptify because renaming that package is an ops decision. The page says so rather than picking one.

Existing pinned-commit source links into the archived repositories were left alone. They resolve, and rewriting 60+ of them belongs in its own PR if you want it.

Checked and skipped

npm run docs:build is green.

dobby-coder Bot added 2 commits August 1, 2026 23:12
…encryption4all/postguard-js#151)

The SDK never shipped a notify-shape validator; the pg-js test suite pins
its removal. `{ notify: true }` sends no mail and suppresses the
silent-upload notice instead of throwing.
postguard-website, postguard-tb-addon, postguard-outlook-addon and
postguard-examples were folded into the postguard-js pnpm workspace and
archived (encryption4all/postguard-js#132, #134, #137, #141, #145).
Cryptify's source moved into the postguard Cargo workspace, with image
publishing left behind in its own repository (encryption4all/postguard#277).
@dobby-coder
dobby-coder Bot requested a review from rubenhensen August 1, 2026 23:19
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.

0 participants