Add Docusaurus documentation site + GitHub Pages deploy#690
Conversation
Adds a complete documentation site under website/ (49 pages: getting started, concepts, CLI/TUI, server/API, workflows, integrations, tutorials, operations, reference) built with Docusaurus 3, the Vercel Geist design system, Tailwind + ShadCN-style components, and lucide icons. Includes an interactive RunRequestBuilder and a live event viewer. Repoints the existing `pages` workflow to build website/ and publish it to GitHub Pages; sets baseUrl to /go-code/ for the project site at https://dennisonbertram.github.io/go-code/. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: fd0f1409c6
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
|
|
||
| `symphd` supports five values for `workspace_type`. Choose based on your isolation and provisioning needs. | ||
|
|
||
| <Tabs> |
There was a problem hiding this comment.
When this page first loads, this <Tabs> root has no defaultValue; because the shared wrapper is just TabsPrimitive.Root in website/src/components/ui/Tabs.tsx, Radix leaves every TabsContent inactive until a trigger is clicked. That makes the workspace-type explanation render as an empty tab strip on initial load. Set defaultValue="local" here (and equivalents for the other no-default groups) or make the wrapper select the first tab by default.
Useful? React with 👍 / 👎.
| ``` | ||
|
|
||
| <Callout variant="info" title="No API key needed to smoke-test"> | ||
| The daemon supports a fake provider mode that requires no LLM credentials. To run the key-free server smoke test: <code>go test ./internal/server/... -run TestRunSmoke</code>. See the <a href="/docs/getting-started/quickstart">Quickstart</a> for a full walkthrough using <code>HARNESS_PROVIDER=fake</code>. |
There was a problem hiding this comment.
Because the site is configured with baseUrl: '/go-code/', this raw HTML <a href="/docs/..."> is emitted as a root-relative /docs/... link rather than /go-code/docs/... on GitHub Pages, so readers clicking it from the published site leave the app and hit a 404. Use a Markdown/Docusaurus Link or useBaseUrl for these raw anchors; the same pattern appears in the what-is-go-code card links.
Useful? React with 👍 / 👎.
1 participant
Adds a complete documentation site under
website/and publishes it to GitHub Pages at https://dennisonbertram.github.io/go-code/.RunRequestBuilderthat generates the/v1/runsJSON + curl.pagesworkflow to buildwebsite/and deploy viaactions/deploy-pages;baseUrlset to/go-code/for the project site.🤖 Generated with Claude Code