Skip to content

feat: add VitePress documentation site#110

Merged
alukach merged 4 commits intorefactor/cf-workers-proxyfrom
claude/zen-matsumoto
Mar 1, 2026
Merged

feat: add VitePress documentation site#110
alukach merged 4 commits intorefactor/cf-workers-proxyfrom
claude/zen-matsumoto

Conversation

@alukach
Copy link
Contributor

@alukach alukach commented Mar 1, 2026

Summary

  • Adds a comprehensive VitePress documentation site in docs/ covering authentication, configuration, deployment, architecture, and extension points
  • Organized into user-facing guide (accessing data) and admin-facing sections (deploying/configuring the proxy)
  • Styled to match docs.source.coop visual identity: IBM Plex Sans body, Cascadia Mono headings, warm off-white/teal-gray color scheme

Test plan

  • cd docs && pnpm install && pnpm docs:dev — site builds and serves locally
  • Navigate all sidebar links — no broken links
  • Mermaid diagrams render correctly
  • Light and dark themes both render properly
  • Code examples are syntactically valid

🤖 Generated with Claude Code

Comprehensive docs site covering authentication, configuration,
deployment, architecture, and extension points. Organized into
user-facing guide and admin-facing sections. Styled to match
docs.source.coop visual identity (IBM Plex Sans, Cascadia Mono
headings, warm off-white/teal-gray color scheme).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add user-facing Endpoints page documenting global (data.source.coop)
vs regional (us-west-2.data.source.coop) proxy endpoints, with
guidance on when to use each for throughput and egress cost savings.

Fix mermaid diagrams using literal \n for line breaks — replace
with <br> tags for proper rendering.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@alukach alukach changed the base branch from main to refactor/cf-workers-proxy March 1, 2026 19:15
alukach and others added 2 commits March 1, 2026 14:36
Add a narrative section to the homepage explaining the five core
motivations: unified interface across backends, native S3 compatibility,
metered access for sustainable open data, flexible OIDC auth on both
frontend and backend, and multi-runtime deployment.

Update feature cards to lead with user-facing value (Unified Interface,
Native S3 Compatibility, Metered Access, Flexible Auth) rather than
implementation details.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Builds the VitePress site and deploys to GitHub Pages on pushes
to main that touch docs/ or the workflow file. Supports manual
dispatch via workflow_dispatch.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@alukach alukach merged commit beaa3a9 into refactor/cf-workers-proxy Mar 1, 2026
7 checks passed
@alukach alukach deleted the claude/zen-matsumoto branch March 1, 2026 22:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant