docs(fumadocs): document Notra blog refresh, cache-off build, and deploy hook

[tembo]

Why

#113 changed how the Notra-powered blog refreshes, but apps/fumadocs/README.md still described the old behavior. It said the blog rebuilt weekly, never explained the build-cache caveat that was the entire point of #113, and didn't document the new webhook trigger or the deploy-hook secret. This update brings the docs in line with the merged code.

Docs updated

apps/fumadocs/README.md → expanded the Blog content (Notra) section with two new subsections:

• How new posts go live — clarifies that publishing in Notra does not update the site on its own; a post only appears when a deploy re-runs the fetch. Documents that build caching is disabled for this app ("cache": false in apps/fumadocs/turbo.json) so every deploy actually re-runs the fetch instead of serving a turbo/Vercel cache hit that would skip it.
• Refresh workflow and deploy hook — documents the three triggers (repository_dispatch notra-published webhook, daily safety-net schedule, manual workflow_dispatch), and the VERCEL_DEPLOY_HOOK_URL secret setup (Vercel → Settings → Git → Deploy Hooks, branch main), noting the workflow no-ops cleanly until the secret is set.

Codepaths covered

• apps/fumadocs/turbo.json — build.cache: false
• .github/workflows/blog-schedule.yml — workflow_dispatch / repository_dispatch: [notra-published] / daily schedule (30 13 * * *), deploy-hook POST with no-op guard
• apps/fumadocs/scripts/fetch-notra-posts.ts — build-time fetch → src/lib/notra-posts.generated.ts

Key knowledge gaps addressed

• The non-obvious why behind cache: false: a same-commit rebuild could turbo-cache-hit and silently skip the Notra fetch, so published posts never appeared.
• Corrected the stale "weekly" claim to the current daily schedule.
• Documented the webhook (notra-published) path and the required VERCEL_DEPLOY_HOOK_URL secret, including the clean no-op when it's unset.

All claims were verified against source (turbo config, workflow YAML, fetch script, and the existing sitemap/RSS/JSON feed routes). Documentation-only change — no code touched.

Want tembo to make any changes? Add a comment with @tembo and i'll get back to work!

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
email-sdk-fumadocs	Ready	Preview, Comment	Jun 28, 2026 2:47am

[tembo]

Requesting review from @leoisadev1 who has experience with the following files modified in this PR:

• apps/fumadocs/README.md

[leoisadev1]

Closing: documents the pre-SSR build-time blog, superseded by #121 (SSR architecture README).