feat: initialize Docusaurus-based documentation project with core concept and feature guides

Author: programmersd21

.github/workflows/deploy-docs.yml

@@ -0,0 +1,46 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+          cache-dependency-path: docs/package.json
+
+      - name: Install dependencies
+        run: npm install
+        working-directory: docs
+
+      - name: Build website
+        run: npm run build
+        working-directory: docs
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/build
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+        

docs/.gitignore

@@ -0,0 +1,5 @@
+.docusaurus
+.cache
+.temp
+build
+node_modules

docs/README.md

@@ -0,0 +1,38 @@
+# Kairo Documentation
+
+This folder contains the source code for the Kairo documentation website, built with [Docusaurus](https://docusaurus.io/).
+
+## Structure
+
+- `docs/`: The actual documentation Markdown files.
+- `src/`: Custom React pages and global CSS.
+- `static/`: Static assets (images, etc.).
+- `docusaurus.config.js`: Site configuration.
+- `sidebars.js`: Sidebar organization.
+
+## How to use
+
+### Local Development
+
+1. Navigate to the `docs/` directory.
+2. Install dependencies: `npm install`.
+3. Start the development server: `npm start`.
+4. Open `http://localhost:3000` in your browser.
+
+### Visual Assets
+
+The documentation uses PNG images stored in `docs/assets/`. These are referenced in the Markdown files using the `require()` syntax for optimal Docusaurus processing.
+
+To update an image:
+1. Replace the file in `docs/assets/` with a new version (keep the same filename).
+2. Or, add a new image to `docs/assets/` and update the corresponding Markdown file.
+
+### Deployment
+
+A GitHub Action is already configured in `.github/workflows/deploy-docs.yml`. It will automatically:
+1. Build the documentation.
+2. Deploy it to your GitHub Pages site (typically `https://<username>.github.io/kairo/`) whenever you push changes to the `main` branch.
+
+## Contributing
+
+If you find errors or want to add new sections, please edit the files in this directory and submit a Pull Request.