-
Notifications
You must be signed in to change notification settings - Fork 2.8k
Migrate Roo-Code-Docs into monorepo as apps/docs #11053
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Migrate Roo-Code-Docs into monorepo as apps/docs #11053
Conversation
|
Generated with ❤️ by ellipsis.dev |
Re-review complete. No outstanding issues.
Mention @roomote in a comment to request specific changes to this pull request or fix all unresolved issues. |
328d40d to
172f552
Compare
8da7a0e to
87009d3
Compare
- Add docs app with Docusaurus configuration - Sync content from Roo-Code-Docs repository - Configure webpack extensionAlias for monorepo TS resolution - Maintain consistency: @roo-code/types exports source files - Add docs:dev, docs:build, docs:serve convenience scripts - Fix broken provider references (claude-code, human-relay)
87009d3 to
afb80b5
Compare
The reference to .github/workflows/docusaurus-build.yml was incorrect as this workflow doesn't exist in the monorepo. Updated to reflect that CI injects environment variables via Vercel configuration.
mrubens
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm no longer sure this is the right direction, since we also want to be able to document cloud features. Let's discuss more.
Based on the work from PR #10943.
This PR migrates the standalone Roo-Code-Docs repository into the Roo-Code monorepo as
apps/docs.Summary of Changes
Documentation Migration
Roo-Code-Docstoapps/docs@roo-code/docspackage with monorepo-compatible dependencies@roo-code/typesdependency toworkspace:^for tighter integrationConfiguration Updates
docusaurus.config.tseditUrlto point toapps/docs/path in monorepo@roo-code/typespackage.json to export built files instead of source files (prevents Webpack resolution errors)@docusaurus/plugin-content-docs,@docusaurus/theme-common,@easyops-cn/autocomplete.jsturbo.jsonto include docs-specific build outputs (.docusaurus/**,build/**)Build & Type Fixes
inertattribute in MobileSidebar component.gitignorefor docs to exclude build artifactspnpm --filter @roo-code/docs buildDocumentation
apps/docs/README.mdwith:Deployment Setup Required
GitHub Actions Workflows
Two workflow files need to be manually added (GitHub App lacks workflow permissions):
.github/workflows/docs-deploy.yml- Deploy to Vercel on push to main.github/workflows/docs-preview.yml- Deploy preview on PRThese files are available in the unstaged changes.
Vercel Configuration
Required secrets in GitHub repository settings:
VERCEL_TOKEN- Personal Access Token from VercelVERCEL_ORG_ID- Organization ID from VercelVERCEL_DOCS_PROJECT_ID- Project ID for docsPOSTHOG_API_KEY- PostHog analytics key (optional)INTERCOM_APP_ID- Intercom widget ID (optional)Vercel project settings:
apps/docspnpm buildbuildpnpm install --frozen-lockfiledocs.roocode.comPost-Merge Tasks
Roo-Code-Docsrepository with a redirect noticeView task on Roo Code Cloud