organize docs for contributing guide (#883)

* Update icon.svg

* organize contributing section

* Update custom.css

* fix link

* Update docusaurus.config.ts

Author: badmonster0

CONTRIBUTING.md

@@ -1 +1 @@
-We love contributions from our community ❤️. Please check out our [contributing guide](https://cocoindex.io/docs/about/contributing).
+We love contributions from our community ❤️. Please check out our [contributing guide](https://cocoindex.io/docs/contributing/guide).

docs/docs/about/community.md

@@ -12,7 +12,7 @@ We are super excited for community contributions of all kinds - whether it's cod
 We would love to foster an inclusive, welcoming, and supportive environment. Contributing to CocoIndex should feel collaborative, friendly and enjoyable for everyone. Together, we can build better AI applications through robust data infrastructure.
 
 :::tip Start hacking CocoIndex
-Check out our [Contributing guide](./contributing) to get started!
+Check out our [Contributing guide](/docs/contributing/guide) to get started!
 :::
 
 

docs/docs/about/contributing.md docs/docs/contributing/guide.mddocs/docs/about/contributing.md renamed to docs/docs/contributing/guide.md

@@ -1,68 +1,20 @@
 ---
-title: Contributing
-description: Learn how to contribute to CocoIndex
+title: Contributing Guide
+description: How to contribute to CocoIndex
 ---
 
-# Contributing
-
 [CocoIndex](https://github.com/cocoindex-io/cocoindex) is an open source project. We are respectful, open and friendly. This guide explains how to get involved and contribute to [CocoIndex](https://github.com/cocoindex-io/cocoindex).
 
-## Issues:
-
-We use [GitHub Issues](https://github.com/cocoindex-io/cocoindex/issues) to track bugs and feature requests.
+Our [Discord server](https://discord.com/invite/zpA9S2DR7s) is constantly open. 
+If you are unsure about anything, it is a good place to discuss! We'd love to collaborate and will always be friendly.
 
 ## Good First Issues
 
 We tag issues with the ["good first issue"](https://github.com/cocoindex-io/cocoindex/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) label for beginner contributors.
 
 ## How to Contribute
-- If you decide to work on an issue, unless the PR can be sent immediately (e.g. just a few lines of code), we recommend you to leave a comment on the issue like **`I'm working on it`**  or **`Can I work on this issue?`** to avoid duplicating work.
+- If you decide to take an issue, we recommend you to leave a comment on the issue like  **`Can I work on this issue?`** so we could assign it to you. This helps you and others avoid duplicating work.
 - For larger features, we recommend you to discuss with us first in our [Discord server](https://discord.com/invite/zpA9S2DR7s) to coordinate the design and work.
-- Our [Discord server](https://discord.com/invite/zpA9S2DR7s) is constantly open. If you are unsure about anything, it is a good place to discuss! We'd love to collaborate and will always be friendly.
-
-## Start hacking! Setting Up Development Environment
-Follow the steps below to get cocoindex built on the latest codebase locally - if you are making changes to cocoindex functionality and want to test it out.
-
--   🦀 [Install Rust](https://rust-lang.org/tools/install)
-
-    If you don't have Rust installed, run
-    ```sh
-    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
-    ```
-    Already have Rust? Make sure it's up to date
-    ```sh
-    rustup update
-    ```
-
--   Setup Python virtual environment:
-    ```sh
-    python3 -m venv .venv
-    ```
-    Activate the virtual environment, before any installing / building / running:
-
-    ```sh
-    . .venv/bin/activate
-    ```
-
--   Install required tools:
-    ```sh
-    pip install maturin
-    ```
-
--   Build the library. Run at the root of cocoindex directory:
-    ```sh
-    maturin develop -E all,dev
-    ```
-
--   Install and enable pre-commit hooks. This ensures all checks run automatically before each commit:
-    ```sh
-    pre-commit install
-    ```
-
--   Before running a specific example, set extra environment variables, for exposing extra traces, allowing dev UI, etc.
-    ```sh
-    . ./.env.lib_debug
-    ```
 
 ## Submit Your Code
 CocoIndex is committed to the highest standards of code quality. Please ensure your code is thoroughly tested before submitting a PR.
@@ -89,6 +41,7 @@ In your PR description, please include:
 - Note if it's a breaking change
 - Reference any related GitHub issues
 
+
 A core team member will review your PR within one business day and provide feedback on any required changes. Once approved and all tests pass, the reviewer will squash and merge your PR into the main branch.
 
 Your contribution will then be part of CocoIndex! We'll highlight your contribution in our release notes 🌴.

docs/docs/contributing/setup_dev_environment.md

@@ -0,0 +1,47 @@
+---
+title: Setup Development Environment
+description: Learn how to setup your development environment to develop CocoIndex
+---
+
+Follow the steps below to get CocoIndex built on the latest codebase locally - if you are making changes to CocoIndex functionality and want to test it out.
+
+-   🦀 [Install Rust](https://rust-lang.org/tools/install)
+
+    If you don't have Rust installed, run
+    ```sh
+    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+    ```
+    Already have Rust? Make sure it's up to date
+    ```sh
+    rustup update
+    ```
+
+-   Setup Python virtual environment:
+    ```sh
+    python3 -m venv .venv
+    ```
+    Activate the virtual environment, before any installing / building / running:
+
+    ```sh
+    . .venv/bin/activate
+    ```
+
+-   Install required tools:
+    ```sh
+    pip install maturin
+    ```
+
+-   Build the library. Run at the root of cocoindex directory:
+    ```sh
+    maturin develop -E all,dev
+    ```
+
+-   Install and enable pre-commit hooks. This ensures all checks run automatically before each commit:
+    ```sh
+    pre-commit install
+    ```
+
+-   Before running a specific example, set extra environment variables, for exposing extra traces, allowing dev UI, etc.
+    ```sh
+    . ./.env.lib_debug
+    ```

docs/docusaurus.config.ts

@@ -65,6 +65,10 @@ const config: Config = {
             from: '/ops/storages',
             to: '/ops/targets',
           },
+          {
+            from: '/about/contributing',
+            to: '/contributing/guide',
+          },
         ],
       },
     ],

docs/sidebars.ts

@@ -66,13 +66,21 @@ const sidebars: SidebarsConfig = {
       id: 'query',
       label: 'Query Support',
     },
+    {
+      type: 'category',
+      label: 'Contributing',
+      collapsed: false,
+      items: [
+        'contributing/guide',
+        'contributing/setup_dev_environment',
+      ],
+    },
     {
       type: 'category',
       label: 'About',
       collapsed: false,
       items: [
         'about/community',
-        'about/contributing',
       ],
     },
   ],

docs/src/css/custom.css

@@ -97,11 +97,17 @@
   }
 }
 
+.navbar__logo{
+  height: 24px;
+  line-height: 24px;
+  margin-right: 4px;
+}
+
 .navbar__title {
-  font-family: 'Questrial', sans-serif;
-  font-size: 1.125rem;
-  /* 18px */
+  font-size: 1.125rem; /* 18px */
   color: var(--my-color-text-black);
+  font-weight: bold;
+  font-family: 'Helvetica Neue', Arial, sans-serif;
 }
 
 .navbar {
@@ -110,7 +116,9 @@
   /* 14px */
   border-bottom: 1px solid var(--ifm-color-emphasis-200);
 }
-
+.navbar__item{
+  margin-top: 3px;
+}
 .sidebarItemTitle_pO2u,
 .navbar__items {
   font-family: 'Questrial', sans-serif;