Skip to content

Add CI for documentation. Minor improvement and organisation of website#350

Merged
luoyuxia merged 1 commit into
apache:mainfrom
leekeiabstraction:setup-ci-for-website-IT
Feb 18, 2026
Merged

Add CI for documentation. Minor improvement and organisation of website#350
luoyuxia merged 1 commit into
apache:mainfrom
leekeiabstraction:setup-ci-for-website-IT

Conversation

@leekeiabstraction
Copy link
Copy Markdown
Contributor

Purpose

Linked issue: close #347

Brief change log

  • Add website integration test (compilation, check for broken links), similar to Java side
  • Ignore website / md files from main CI run
  • Fixed broken links
  • Minor reorganisation
  • Added Java section which links to main Fluss website

Tests

  • Local npm build and start runs successfully.
  • Verified links by clicking through

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a dedicated GitHub Actions workflow to build the Docusaurus website (catching broken links via Docusaurus settings) and adjusts the main CI trigger to skip runs for website/markdown-only changes, alongside small documentation/website organization updates.

Changes:

  • Add a new docs-check workflow to build the website on website/** changes.
  • Update main CI triggers to ignore website/** and **/*.md-only changes.
  • Reorganize website navigation and fix/adjust documentation links and labels.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
website/sidebars.ts Renames “User Guide” category to “Clients”, adds external Java link, and surfaces Contributing directly.
website/docs/user-guide/*/example/_category_.json Renames “Example” to “Examples” in multiple language sections.
website/docs/release/verifying-a-release-candidate.md Fixes/updates internal docs links to match current website structure.
website/docs/release/generate-release-note.md Updates links, but introduces an instruction/link mismatch for release-note generation flow.
website/docs/index.md Updates intro text and section naming to match the new sidebar organization and Java link.
website/docs/developer-guide/_category_.json Removes the Developer Guide category metadata (sidebar now links directly to Contributing).
.github/workflows/docs-check.yml Adds website build workflow, but uses likely-invalid action major versions.
.github/workflows/ci.yml Adds paths-ignore to avoid running main CI for website/markdown-only changes.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread website/docs/release/generate-release-note.md
Copy link
Copy Markdown
Contributor

@luoyuxia luoyuxia left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@leekeiabstraction Thanks for the pr. LGTM. Merging...

@luoyuxia luoyuxia merged commit 2e0ab9b into apache:main Feb 18, 2026
24 checks passed
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.

Setup CI to integration test website

3 participants