This directory contains the source for the Apache Paimon documentation site, built with Docusaurus 3.

• Node.js >= 18
• Yarn (npm install -g yarn)

# Install dependencies
yarn install

# Start development server (with hot reload)
yarn start

The site will be available at http://localhost:3000/docs/master/.

# Validate the REST OpenAPI contracts
yarn test:rest-openapi

# Production build
yarn build

# Preview the production build locally
yarn serve

docs/
├── docs/              # Markdown/MDX content files
├── generated/         # Auto-generated config tables (from paimon-docs module)
├── src/
│   ├── components/    # Custom React components (Stable, Unstable, ConfigTable, etc.)
│   ├── css/           # Custom styles
│   └── plugins/       # Remark plugins (variable interpolation)
├── static/            # Static assets (images, logos, OpenAPI spec)
├── scripts/           # Documentation validation and migration utilities
├── docusaurus.config.js
├── sidebars.js
└── package.json

The 28 HTML config tables in generated/ are produced by the paimon-docs Maven module. To regenerate:

cd .. && mvn -pl paimon-docs -am package -DskipTests

1. Create a .md (or .mdx if you need React components like Tabs) file under docs/
2. Add frontmatter:

   ---
   title: "Page Title"
   sidebar_position: 5
   ---

3. The page will automatically appear in the sidebar based on sidebar_position

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

<Tabs groupId="engine">
<TabItem value="flink" label="Flink">

Flink content here.

</TabItem>
<TabItem value="spark" label="Spark">

Spark content here.

</TabItem>
</Tabs>

Use @@VERSION@@ in markdown and it will be replaced with the current version (1.5-SNAPSHOT) at build time. Other available tokens:

• @@VERSION@@ — Paimon version
• @@FLINK_VERSION@@ — Flink version
• @@BRANCH@@ — Git branch
• @@GITHUB_REPO@@ — GitHub repo URL