[website] Organizing Community Documentation with a Sidebar (#538)

Author: wuchong

website/community/how-to-contribute/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "How to Contribute",
+  "position": 2
+}

website/community/how-to-contribute/contribute-code.md

@@ -0,0 +1,11 @@
+---
+sidebar_label: Contribute Code
+sidebar_position: 1
+---
+
+# Contribute Code
+
+TODO
+
+
+

website/community/how-to-contribute/contribute-docs.md

@@ -0,0 +1,9 @@
+---
+sidebar_label: Contribute Documentation
+sidebar_position: 1
+---
+
+# Contribute Documentation
+
+TODO
+

website/community/how-to-contribute/index.md

@@ -0,0 +1,8 @@
+---
+sidebar_position: 1
+---
+
+# How to Contribute
+
+TODO
+

website/community/how-to-release.md

@@ -0,0 +1,9 @@
+---
+sidebar_label: How to Release
+sidebar_position: 3
+---
+
+# How to Release
+
+TODO
+

website/src/pages/community.md website/community/welcome.mdwebsite/src/pages/community.md renamed to website/community/welcome.md

@@ -1,3 +1,8 @@
+---
+sidebar_label: Welcome
+sidebar_position: 1
+---
+
 # Welcome to Fluss Community
 
 ## Issues

website/docusaurus.config.ts

@@ -56,8 +56,8 @@ const config: Config = {
       {
         docs: {
           sidebarPath: './sidebars.ts',
-          editUrl: ({versionDocsDirPath, docPath}) =>
-              `https://github.com/alibaba/fluss/tree/main/website/docs/${docPath}`,
+          editUrl: ({docPath}) =>
+              `https://github.com/alibaba/fluss/edit/main/website/docs/${docPath}`,
           remarkPlugins: [versionReplace],
         },
         blog: {
@@ -77,6 +77,19 @@ const config: Config = {
     ],
   ],
   plugins: [
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'community',
+        path: 'community',
+        routeBasePath: 'community',
+        sidebarPath: './sidebarsCommunity.js',
+        editUrl: ({docPath}) => {
+          return `https://github.com/alibaba/fluss/edit/main/website/community/${docPath}`;
+        },
+        // ... other options
+      },
+    ],
     [
       '@docusaurus/plugin-pwa',
       {
@@ -115,7 +128,7 @@ const config: Config = {
           label: 'Docs',
         },
         {to: '/blog', label: 'Blog', position: 'left'},
-        {to: '/community', label: 'Community', position: 'left'},
+        {to: '/community/welcome', label: 'Community', position: 'left'},
         {to: '/roadmap', label: 'Roadmap', position: 'left'},
         {to: '/downloads', label: 'Downloads', position: 'left'},
         {

website/sidebarsCommunity.js

@@ -0,0 +1,25 @@
+/*
+ *  Copyright (c) 2025 Alibaba Group Holding Ltd.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
+export default {
+    community: [
+        {
+            type: 'autogenerated',
+            dirName: '.',
+        }
+    ],
+};

website/src/pages/roadmap.md

@@ -33,7 +33,7 @@ This transition aims to streamline operations and enhance system reliability.
 
 - Support for complex data types: Array ([#168](https://github.com/alibaba/fluss/issues/168)), Map ([#169](https://github.com/alibaba/fluss/issues/169)), Struct ([#170](https://github.com/alibaba/fluss/issues/170)), Variant/JSON.
 - Support for schema evolution.
-- Support for secondary index for Delta Join with Flink ([#65](https://github.com/alibaba/fluss/issues/65)).
+- Support for secondary index for Delta Join with Flink (~~[#65](https://github.com/alibaba/fluss/issues/65)~~).
 - Support for buckets rescale.
 
 ## Zero Disks

website/src/theme/NavbarItem/DocsVersionDropdownNavbarItem.js

@@ -22,7 +22,7 @@ import useRouteContext from '@docusaurus/useRouteContext';
 export default function DocsVersionDropdownNavbarItemWrapper(props) {
     const {plugin} = useRouteContext();
 
-    if (plugin.name === "docusaurus-plugin-content-docs") {
+    if (plugin.name === "docusaurus-plugin-content-docs" && plugin.id !== "community") {
         return (
             <>
                 <DocsVersionDropdownNavbarItem {...props} />