Move docs into web/content/docs for reliable Lambda bundling#617
Move docs into web/content/docs for reliable Lambda bundling#617willwashburn merged 3 commits intomainfrom
Conversation
The docs .mdx files were in the repo root docs/ directory and relied on outputFileTracingIncludes to get bundled into the Lambda function. This was fragile and caused Access Denied errors in production when the files weren't included. Moving them into web/content/docs/ (same pattern as blog) ensures they're automatically bundled. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Delete Mintlify config, assets, and MDX source from docs/ - Move plain markdown mirror from docs/markdown/ up to docs/ - web/content/docs/*.mdx is now the single MDX source - docs/*.md is the plain markdown mirror Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
![devin-ai-integration[bot]](https://avatars.githubusercontent.com/in/811515?s=60&v=4){kind=small}
docs/introduction.md
Outdated
| <Card title="📄 Markdown Docs on GitHub" icon="file-lines" href="https://github.com/AgentWorkforce/relay/tree/main/docs/markdown"> | ||
| Plain-text versions of every page — no MDX components, no JavaScript. Designed for `curl`, agents, and language models. | ||
| </Card> |
There was a problem hiding this comment.
🔴 Stale link to removed docs/markdown directory in introduction.mdx (docs-sync rule violation)
The .md mirror at docs/introduction.md:94 was correctly updated to link to https://github.com/AgentWorkforce/relay/tree/main/docs, but the corresponding MDX source at web/content/docs/introduction.mdx:105 still references the old https://github.com/AgentWorkforce/relay/tree/main/docs/markdown path, which was deleted in this PR. This violates the docs-sync rule (.claude/rules/docs-sync.md, rule 1): "Any change to an .mdx file must be mirrored to the corresponding .md file, and vice versa." The stale URL will render as a broken 404 link on the production docs site.
Was this helpful? React with 👍 or 👎 to provide feedback.
- Convert <CardGroup>/<Card> to plain markdown lists - Fix <Note> blockquote continuation lines - Restore SDK reference sections lost by incorrect --- stripping - Fix broken docs/markdown link to docs/ Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
| # @agent-relay/openclaw | ||
|
|
||
| Relaycast bridge for OpenClaw — connects your OpenClaw instances to Relaycast for real-time multi-agent communication across channels, DMs, and threads. |
There was a problem hiding this comment.
🟡 Duplicate H1 headings in openclaw.md
The new content added to docs/reference/openclaw.md introduces a second # (H1) heading. Lines 1 and 5 are both H1: # OpenClaw Bridge and # @agent-relay/openclaw. The MDX source (web/content/docs/reference/openclaw.mdx) has the title "OpenClaw Bridge" in frontmatter and only # @agent-relay/openclaw in the body. The .md mirror should have a single H1 derived from the frontmatter title, not two competing H1 headings.
| # @agent-relay/openclaw | |
| Relaycast bridge for OpenClaw — connects your OpenClaw instances to Relaycast for real-time multi-agent communication across channels, DMs, and threads. | |
| # OpenClaw Bridge | |
| Relaycast bridge for OpenClaw -- real-time multi-agent messaging and spawning. |
Was this helpful? React with 👍 or 👎 to provide feedback.
1 participant
Summary
.mdxfiles intoweb/content/docs/(same pattern asweb/content/blog/)docs.tsto read from the localcontent/docs/directory instead of../docs/../docs/**/*.mdxfromoutputFileTracingIncludes— no longer neededdocs/**/*.mdxfrom deploy workflow trigger (covered byweb/**)Why
The docs were in the repo root
docs/directory and relied onoutputFileTracingIncludesto get bundled into the Lambda. After SST remove + redeploy, the files weren't being included, causing Access Denied on all/docsroutes.Test plan
next buildpasses locally/docsroutes work/docs/quickstart,/docs/reference/sdkall load🤖 Generated with Claude Code