Skip to content

feat(theme): add the new shared theme, governance docs, and CI to main (2/2) - #1020

Merged
AmilaSamith merged 3 commits into
wso2:mainfrom
AmilaSamith:feat/upstream-shared-theme-main
Oct 19, 2026
Merged

AmilaSamith merged 3 commits into
wso2:mainfrom
AmilaSamith:feat/upstream-shared-theme-main

Conversation

@AmilaSamith

Copy link
Copy Markdown
Contributor

Summary

Step 2 of 2 for migrating main to the new shared-theme/governance model -- see PR 1/2 for the removal of the old content this replaces.

Adds:

  • The shared theme (en/src/theme, theme-shared, theme-local, custom.css) -- authored once here, fanned out to every product branch by sync-theme.yaml.
  • The theme-local/ per-branch extension-point mechanism (RootExtras, sidebarTransform), so a product branch can hook into shared theme internals without hand-editing them (and having the next sync silently revert it).
  • Governance docs: MAINTENANCE.md, CONTRIBUTING.md, AGENTS.md, HOW_TO_WRITE_A_GUIDE.md, UI_UX_GUIDELINES.md.
  • The pipeline workflows: sync-theme.yaml, staging_sync.yaml, promote_to_production.yaml, fork_preview.yaml, plus CI (broken-link-check.yaml, claude_runner.yml, etc.).

206 additions, 23 modifications, 4 renames -- 233 files total.

⚠️ Diff will look huge until PR 1/2 merges

This branch is built on top of PR 1/2's commit, so until that one merges, GitHub will show this PR's diff as the combined change (~4,400 files). Once PR 1/2 merges into main, this PR's diff automatically narrows down to just these 233 files -- that's expected, not a sign something's wrong. Please merge PR 1/2 first.

Why split into two PRs

See PR 1/2 -- the combined change was timing out GitHub's rule evaluation on merge.

🤖 Generated with Claude Code

Step 2 of 2 for promoting the new shared-theme/governance main (built on
the fork) to this repo -- see step 1's commit message for the full
context. Adds the shared theme (en/src/theme, theme-shared, theme-local,
custom.css), the per-branch theme-local extension-point mechanism,
governance docs (MAINTENANCE.md, CONTRIBUTING.md, AGENTS.md,
HOW_TO_WRITE_A_GUIDE.md, UI_UX_GUIDELINES.md), and the sync/staging/CI
workflows (sync-theme.yaml, staging_sync.yaml, promote_to_production.yaml,
fork_preview.yaml, broken-link-check.yaml, claude_runner.yml, etc.) that
fan this content out to and build each product branch.

Co-Authored-By: Claude Sonnet 5 <[email protected]>
@coderabbitai

coderabbitai Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Important

Review skipped

Too many files!

This PR contains 172 files, which is 72 over the limit of 100.

To get a review, reduce the PR to 100 files or fewer by splitting it into smaller PRs or changing its base branch.

Upgrade to a paid plan to raise the limit.

This review couldn't start because sufficient usage credits or metered capacity aren't available. Add credits or update usage-based reviews in the billing tab, then retry.

⚙️ Run configuration
  • Configuration used: Repository: wso2/docs-integrator/.coderabbit.yaml
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 0c79193f-45fa-4822-bf87-16110737e62f
📥 Commits

Reviewing files that changed from the base of the PR and between 050a949 and d0bbe53.

⛔ Files ignored due to path filters: 61
  • en/static/img/artifact-icons/automation.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/aws.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/azure-files.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/chat-agent.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/chat.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/config.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/connection.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/connector.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/data-mapper.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/durable-workflow.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/email.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/file.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/ftp.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/function.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/github.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/google-chat.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/graphql.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/grpc.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/http.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/hubspot.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/kafka.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/mcp.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/mqtt.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/mssql.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/mysql.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/postgresql.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/rabbitmq.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/shopify.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/smb.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/solace.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/tcp.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/telegram.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/type.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/websocket.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/websub.svg is excluded by !**/*.svg
  • en/static/img/artifact-icons/whatsapp.svg is excluded by !**/*.svg
  • en/static/img/branding/ballerina-logo-dark.png is excluded by !**/*.png
  • en/static/img/branding/ballerina-logo-light.png is excluded by !**/*.png
  • en/static/img/integration-platform-logo-black.png is excluded by !**/*.png
  • en/static/img/integration-platform-logo-white.png is excluded by !**/*.png
  • en/static/img/landing/hero.png is excluded by !**/*.png
  • en/static/img/platform-overview/Integration-engineering-lifecycle.png is excluded by !**/*.png
  • en/static/img/platform-overview/ai-in-integration-v5.1.png is excluded by !**/*.png
  • en/static/img/platform-overview/ai-in-integration.png is excluded by !**/*.png
  • en/static/img/platform-overview/deployment-models-v5.1.png is excluded by !**/*.png
  • en/static/img/platform-overview/deployment-models.png is excluded by !**/*.png
  • en/static/img/platform-overview/do-i-need-ballerina.png is excluded by !**/*.png
  • en/static/img/platform-overview/icp.png is excluded by !**/*.png
  • en/static/img/platform-overview/integration-lifecycle-v5.1.png is excluded by !**/*.png
  • en/static/img/platform-overview/integration-lifecycle.png is excluded by !**/*.png
  • en/static/img/platform-overview/integration-paltform-glance.png is excluded by !**/*.png
  • en/static/img/platform-overview/integration-store.png is excluded by !**/*.png
  • en/static/img/platform-overview/integration-styles.png is excluded by !**/*.png
  • en/static/img/platform-overview/ipaas.png is excluded by !**/*.png
  • en/static/img/platform-overview/observability.png is excluded by !**/*.png
  • en/static/img/platform-overview/platform-architecture.png is excluded by !**/*.png
  • en/static/img/platform-overview/wso2-integration-platform-architecture-v5.1.png is excluded by !**/*.png
  • en/static/img/platform-overview/wso2-integrator.png is excluded by !**/*.png
  • en/static/img/wso2-integration-platform-black.svg is excluded by !**/*.svg
  • en/static/img/wso2-integration-platform-full-colour.svg is excluded by !**/*.svg
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing: 172
  • .github/CODEOWNERS
  • .github/workflows/fork_preview.yaml
  • .github/workflows/promote_to_production.yaml
  • .github/workflows/staging_sync.yaml
  • .github/workflows/sync-theme.yaml
  • AGENTS.md
  • CONTRIBUTING.md
  • HOW_TO_WRITE_A_GUIDE.md
  • MAINTENANCE.md
  • README.md
  • UI_UX_GUIDELINES.md
  • en/docs/get-started/_category_.json
  • en/docs/get-started/cloud-setup.md
  • en/docs/get-started/concepts/_category_.json
  • en/docs/get-started/concepts/concepts.mdx
  • en/docs/get-started/get-started.md
  • en/docs/get-started/quickstarts/_category_.json
  • en/docs/get-started/quickstarts/build-ai-agent.md
  • en/docs/get-started/quickstarts/build-integration-api.md
  • en/docs/get-started/quickstarts/quickstarts.md
  • en/docs/guides/_category_.json
  • en/docs/guides/business-use-cases/_category_.json
  • en/docs/guides/business-use-cases/business-use-cases.md
  • en/docs/guides/business-use-cases/sample-inventory-automation.md
  • en/docs/guides/business-use-cases/sample-order-sync.md
  • en/docs/guides/guides.md
  • en/docs/guides/how-to-guides/_category_.json
  • en/docs/guides/how-to-guides/build-a-sample-agent.md
  • en/docs/guides/how-to-guides/build-a-sample-rag-pipeline.md
  • en/docs/guides/how-to-guides/how-to-guides.md
  • en/docs/homepage/_category_.json
  • en/docs/homepage/homepage.md
  • en/docs/icons/_category_.json
  • en/docs/icons/icons.md
  • en/docs/platform-overview/_category_.json
  • en/docs/platform-overview/platform-overview.md
  • en/docs/reference/_category_.json
  • en/docs/reference/faq.md
  • en/docs/reference/glossary.md
  • en/docs/reference/reference.md
  • en/docs/section-1/_category_.json
  • en/docs/section-1/section-1.md
  • en/docs/section-1/sub-section-1/_category_.json
  • en/docs/section-1/sub-section-1/sample-page.md
  • en/docs/section-1/sub-section-1/sub-section-1.md
  • en/docs/section-1/sub-section-2/_category_.json
  • en/docs/section-1/sub-section-2/sub-section-2.md
  • en/docs/section-2/_category_.json
  • en/docs/section-2/page-1.md
  • en/docs/section-2/page-2.md
  • en/docs/section-2/section-2.md
  • en/docs/tools/_category_.json
  • en/docs/tools/skills/_category_.json
  • en/docs/tools/skills/skills.md
  • en/docs/tools/theme-color-palette/_category_.json
  • en/docs/tools/theme-color-palette/theme-color-palette.md
  • en/docs/tools/tools.md
  • en/docs/workflows/_category_.json
  • en/docs/workflows/workflows.md
  • en/docusaurus.config.ts
  • en/i18n/en/code.json
  • en/plugins/docusaurus-plugin-markdown-export/index.js
  • en/sidebars.ts
  • en/src/components/AIAssistantSidePanel/Launcher.tsx
  • en/src/components/AIAssistantSidePanel/index.tsx
  • en/src/components/AIAssistantSidePanel/launcher.module.css
  • en/src/components/AIAssistantSidePanel/styles.module.css
  • en/src/components/AiAssistantPanel/index.tsx
  • en/src/components/AiAssistantPanel/styles.module.css
  • en/src/components/ArtifactPicker/data.ts
  • en/src/components/ArtifactPicker/index.tsx
  • en/src/components/ArtifactPicker/inlineIcons.ts
  • en/src/components/ArtifactPicker/styles.module.css
  • en/src/components/CloudDocsLink/index.tsx
  • en/src/components/ColorSwatch/index.tsx
  • en/src/components/ColorSwatch/styles.module.css
  • en/src/components/ConnectorCatalog/Filters.tsx
  • en/src/components/ConnectorCatalog/context.tsx
  • en/src/components/CookieConsent/index.tsx
  • en/src/components/CookieConsent/styles.module.css
  • en/src/components/DocFeedback/index.tsx
  • en/src/components/DocFeedback/styles.module.css
  • en/src/components/ExploreDropdown/index.tsx
  • en/src/components/ExploreDropdown/styles.module.css
  • en/src/components/FloatingActions/index.tsx
  • en/src/components/FloatingActions/styles.module.css
  • en/src/components/GuidesCatalog/index.tsx
  • en/src/components/GuidesCatalog/styles.module.css
  • en/src/components/IconGallery/index.tsx
  • en/src/components/IconGallery/styles.module.css
  • en/src/components/LandingHero/HeroSearch.tsx
  • en/src/components/LandingHero/heroSearch.module.css
  • en/src/components/LandingHero/index.tsx
  • en/src/components/LandingHero/styles.module.css
  • en/src/components/PaletteCard/index.tsx
  • en/src/components/PaletteIcon/index.tsx
  • en/src/components/Prerequisites/index.tsx
  • en/src/components/Prerequisites/styles.module.css
  • en/src/components/ProductDocsLinks/index.tsx
  • en/src/components/ProductDocsLinks/styles.module.css
  • en/src/components/QuickstartHeader/index.tsx
  • en/src/components/QuickstartHeader/styles.module.css
  • en/src/components/ReportIssueButton/index.tsx
  • en/src/components/ReportIssueButton/styles.module.css
  • en/src/components/SearchBar/index.tsx
  • en/src/components/SearchBar/styles.module.css
  • en/src/components/SidebarProductHeader/index.tsx
  • en/src/components/SidebarProductHeader/styles.module.css
  • en/src/components/Steps/index.tsx
  • en/src/components/Steps/styles.module.css
  • en/src/css/custom.css
  • en/src/pages/community.module.css
  • en/src/pages/community.tsx
  • en/src/pages/contribute.module.css
  • en/src/pages/contribute.tsx
  • en/src/pages/index.module.css
  • en/src/pages/index.tsx
  • en/src/plugins/crossProductLinks.js
  • en/src/plugins/guidesCatalogPlugin.js
  • en/src/theme-local/RootExtras.tsx
  • en/src/theme-local/sidebarTransform.ts
  • en/src/theme-shared/themeConfig.ts
  • en/src/theme/DocBreadcrumbs/MarkdownButton.tsx
  • en/src/theme/DocBreadcrumbs/index.js
  • en/src/theme/DocBreadcrumbs/styles.module.css
  • en/src/theme/DocItem/Layout/index.tsx
  • en/src/theme/DocItem/Layout/styles.module.css
  • en/src/theme/DocItem/TOC/Mobile/index.tsx
  • en/src/theme/DocRoot/Layout/Sidebar/index.tsx
  • en/src/theme/DocRoot/Layout/Sidebar/styles.module.css
  • en/src/theme/DocSidebar/Desktop/SidebarSearch.tsx
  • en/src/theme/DocSidebar/Desktop/icons.tsx
  • en/src/theme/DocSidebar/Desktop/index.tsx
  • en/src/theme/DocSidebar/Desktop/sidebarSearch.module.css
  • en/src/theme/DocSidebar/Desktop/styles.module.css
  • en/src/theme/DocSidebarItem/Category/index.tsx
  • en/src/theme/DocSidebarItem/Category/styles.module.css
  • en/src/theme/DocSidebarItem/Html/index.tsx
  • en/src/theme/DocSidebarItem/Html/styles.module.css
  • en/src/theme/DocSidebarItem/Link/index.tsx
  • en/src/theme/DocSidebarItem/Link/styles.module.css
  • en/src/theme/DocSidebarItems/index.tsx
  • en/src/theme/DocSidebarItems/styles.module.css
  • en/src/theme/DocVersionBanner/index.tsx
  • en/src/theme/DocVersionBanner/styles.module.css
  • en/src/theme/EditThisPage/index.tsx
  • en/src/theme/EditThisPage/styles.module.css
  • en/src/theme/Footer/index.tsx
  • en/src/theme/Footer/styles.module.css
  • en/src/theme/Logo/index.tsx
  • en/src/theme/MDXComponents/A.tsx
  • en/src/theme/MDXComponents/index.tsx
  • en/src/theme/Navbar/Content/index.tsx
  • en/src/theme/Navbar/Content/styles.module.css
  • en/src/theme/Navbar/CopyPageButton.tsx
  • en/src/theme/Navbar/index.tsx
  • en/src/theme/Navbar/styles.module.css
  • en/src/theme/NavbarItem/ComponentTypes.js
  • en/src/theme/Root.js
  • en/src/theme/SearchBar/SearchModal.module.css
  • en/src/theme/SearchBar/SearchModal.tsx
  • en/src/theme/SearchBar/index.tsx
  • en/src/theme/SearchBar/search-local.d.ts
  • en/src/theme/SearchBar/styles.module.css
  • en/src/theme/SearchPage/index.tsx
  • en/src/theme/SearchPage/styles.module.css
  • en/src/theme/TOC/index.tsx
  • en/src/theme/TOC/styles.module.css
  • en/static/skills/wso2-diagram-generator.skill
  • en/static/skills/wso2-docs-generator.skill
  • package.json
  • scripts/preview-all-sites.mjs

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

📝 Walkthrough

[!WARNING]
Review details and warnings were omitted to fit the comment limit.

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Comment @coderabbitai help to get the list of available commands.

rosensilva
rosensilva previously approved these changes Oct 19, 2026
@AmilaSamith
AmilaSamith dismissed rosensilva’s stale review October 19, 2026 10:37

The merge-base changed after approval.

@github-actions

github-actions Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

Broken links, images & orphan pages

❌ Failing — 14 broken link(s)/image(s) found on this branch. The check stays red until all are fixed.

Links/images come from one crawl of the production build (baseUrl-aware). Orphans are docs not referenced by sidebars.ts.

Summary

  • Broken links & images — total 14 · 🆕 introduced 0 · 📄 already on main 14
  • Orphan pages — total 31 (no base-branch data to compare)

Broken links & images

Introduced by this PR

No new broken link(s)/image(s) introduced by this PR. ✅

Already on main — 14 total

Already present on the base branch (not caused by this PR):

Show 14
  • /docs-integrator/connectors/catalog/hrms/sap.successfactors.ectimeoff/setup-guide.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /docs-integrator/connectors/catalog/productivity-collaboration/googleapis.calendar/setup-guide.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /docs-integrator/deploy/cloud/overview.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /docs-integrator/deploy/self-hosted/containerized-deployment.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /docs-integrator/deploy/self-hosted/vm-deployment.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /docs-integrator/develop/integration-artifacts/automation.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /docs-integrator/develop/integration-artifacts/supporting/connections.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /docs-integrator/develop/understand-ide/editors/expression-editor.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /docs-integrator/develop/understand-ide/editors/flow-diagram-editor/control.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /docs-integrator/develop/understand-ide/editors/flow-diagram-editor/statement.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /docs-integrator/get-started/setup/cloud-setup.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /docs-integrator/get-started/setup/local-setup.md (404) — 2 pages, e.g. /docs-integrator/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • /skills/wso2-diagram-generator.skill (404) — 2 pages, e.g. /docs-integrator/tools/skills
  • /skills/wso2-docs-generator.skill (404) — 2 pages, e.g. /docs-integrator/tools/skills

Orphan pages

Introduced by this PR

No base-branch data — see the full list below.

All orphan page(s) on this branch — 31 total

Show 31
  • docs/get-started/cloud-setup
  • docs/get-started/concepts/concepts
  • docs/get-started/get-started
  • docs/get-started/quickstarts/build-ai-agent
  • docs/get-started/quickstarts/build-integration-api
  • docs/get-started/quickstarts/quickstarts
  • docs/guides/business-use-cases/business-use-cases
  • docs/guides/business-use-cases/sample-inventory-automation
  • docs/guides/business-use-cases/sample-order-sync
  • docs/guides/guides
  • docs/guides/how-to-guides/build-a-sample-agent
  • docs/guides/how-to-guides/build-a-sample-rag-pipeline
  • docs/guides/how-to-guides/how-to-guides
  • docs/guides/howtoguides/sf-ec-leave-to-google-calendar-sync
  • docs/homepage/homepage
  • docs/icons/icons
  • docs/platform-overview/platform-overview
  • docs/reference/faq
  • docs/reference/glossary
  • docs/reference/reference
  • docs/section-1/section-1
  • docs/section-1/sub-section-1/sample-page
  • docs/section-1/sub-section-1/sub-section-1
  • docs/section-1/sub-section-2/sub-section-2
  • docs/section-2/page-1
  • docs/section-2/page-2
  • docs/section-2/section-2
  • docs/tools/skills/skills
  • docs/tools/theme-color-palette/theme-color-palette
  • docs/tools/tools
  • docs/workflows/workflows

@AmilaSamith
AmilaSamith merged commit 5832ae6 into wso2:main Oct 19, 2026
3 of 4 checks passed
@AmilaSamith
AmilaSamith deleted the feat/upstream-shared-theme-main branch October 20, 2026 04:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants