refactor: Move build_docs scripts to scripts/ directory

- Create scripts/ directory for utility scripts
- Move build_docs.bat/sh from tools/ to scripts/
- Update all documentation paths to scripts/build_docs.*
- Add scripts/README.md for directory documentation
- Remove build_docs references from tools/README.md
- Follows common project organization pattern

Author: lufftw

docs/BUILD_DOCS_MANUAL.md

@@ -40,20 +40,20 @@ This guide shows you how to build documentation locally using simple batch/shell
 
 ```bash
 # Windows
-build_docs.bat
+scripts\build_docs.bat
 
 # Linux/macOS
-./build_docs.sh
+./scripts/build_docs.sh
 ```
 
 **Build and preview locally:**
 
 ```bash
 # Windows
-build_docs.bat --serve
+scripts\build_docs.bat --serve
 
 # Linux/macOS
-./build_docs.sh --serve
+./scripts/build_docs.sh --serve
 ```
 
 Then visit http://127.0.0.1:8000 in your browser.
@@ -85,10 +85,10 @@ Build the documentation site:
 
 ```bash
 # Windows
-build_docs.bat
+scripts\build_docs.bat
 
 # Linux/macOS
-./build_docs.sh
+./scripts/build_docs.sh
 ```
 
 **Output:** The built site will be in the `site/` directory.
@@ -99,10 +99,10 @@ Build and start a local server to preview:
 
 ```bash
 # Windows
-build_docs.bat --serve
+scripts\build_docs.bat --serve
 
 # Linux/macOS
-./build_docs.sh --serve
+./scripts/build_docs.sh --serve
 ```
 
 Then open http://127.0.0.1:8000 in your browser.
@@ -115,18 +115,18 @@ Remove the existing `site/` directory before building:
 
 ```bash
 # Windows
-build_docs.bat --clean
+scripts\build_docs.bat --clean
 
 # Linux/macOS
-./build_docs.sh --clean
+./scripts/build_docs.sh --clean
 ```
 
 ### Combined Options
 
 ```bash
 # Clean build and serve
-build_docs.bat --clean --serve
-./build_docs.sh --clean --serve
+scripts\build_docs.bat --clean --serve
+./scripts/build_docs.sh --clean --serve
 ```
 
 ---

docs/LOCAL_DOCS_BUILD.md

@@ -29,10 +29,10 @@ This guide provides an overview of different methods to build documentation loca
 **Quick Start:**
 ```bash
 # Windows
-build_docs.bat --serve
+scripts\build_docs.bat --serve
 
 # Linux/macOS
-./build_docs.sh --serve
+./scripts/build_docs.sh --serve
 ```
 
 📖 **[Full Guide →](BUILD_DOCS_MANUAL.md)**
@@ -98,8 +98,8 @@ act -P ubuntu-latest=catthehacker/ubuntu:act-latest -j build
 ```bash
 # 1. No installation needed (just use existing Python venv)
 # 2. Run script
-build_docs.bat --serve    # Windows
-./build_docs.sh --serve   # Linux/macOS
+scripts\build_docs.bat --serve    # Windows
+./scripts/build_docs.sh --serve   # Linux/macOS
 # 3. Done! Visit http://127.0.0.1:8000
 ```
 

scripts/README.md

@@ -0,0 +1,69 @@
+# Scripts Directory
+
+This directory contains utility scripts for project maintenance and development.
+
+> ⚠️ **Note**: These scripts are **optional** and intended for project maintainers and contributors. Core LeetCode practice functionality does NOT require these scripts.
+
+---
+
+## 📋 Available Scripts
+
+### Documentation Build Scripts
+
+| Script | Purpose | Usage |
+|:-------|:--------|:------|
+| `build_docs.bat` / `build_docs.sh` | Build documentation site locally | `scripts\build_docs.bat --serve` (Windows)<br>`./scripts/build_docs.sh --serve` (Linux/macOS) |
+
+**Features:**
+- ✅ No Docker required
+- ✅ No external tools required
+- ✅ Simple one-command build
+- ✅ Fast execution
+
+📖 **[Full Documentation →](../docs/BUILD_DOCS_MANUAL.md)**
+
+---
+
+## 🎯 Usage
+
+### Build Documentation
+
+```bash
+# Windows
+scripts\build_docs.bat
+
+# Linux/macOS
+./scripts/build_docs.sh
+```
+
+### Build and Preview Locally
+
+```bash
+# Windows
+scripts\build_docs.bat --serve
+
+# Linux/macOS
+./scripts/build_docs.sh --serve
+```
+
+Then visit http://127.0.0.1:8000 in your browser.
+
+---
+
+## 📚 Related Documentation
+
+- [Local Documentation Build Options](../docs/LOCAL_DOCS_BUILD.md) - Overview of all local build methods
+- [Manual Build Guide](../docs/BUILD_DOCS_MANUAL.md) - Complete guide for manual script method
+- [Act Guide](../docs/ACT_LOCAL_GITHUB_ACTIONS.md) - Using act to simulate CI/CD
+
+---
+
+## 🔄 Future Scripts
+
+This directory may contain additional utility scripts in the future:
+- Deployment scripts
+- Maintenance scripts
+- Development helper scripts
+
+All scripts will follow the same naming convention: `script_name.bat` (Windows) and `script_name.sh` (Linux/macOS).
+

build_docs.bat scripts/build_docs.batbuild_docs.bat renamed to scripts/build_docs.bat

@@ -3,13 +3,15 @@ chcp 65001 >nul
 REM ============================================
 REM  Build Documentation Locally
 REM  Usage: 
-REM    build_docs.bat              (build only)
-REM    build_docs.bat --serve      (build and serve locally)
-REM    build_docs.bat --clean      (clean build directory first)
+REM    scripts\build_docs.bat              (build only)
+REM    scripts\build_docs.bat --serve      (build and serve locally)
+REM    scripts\build_docs.bat --clean      (clean build directory first)
 REM ============================================
 
-set BASE_DIR=%~dp0
-set VENV_PYTHON=%BASE_DIR%leetcode\Scripts\python.exe
+REM Get project root directory (parent of scripts/)
+set SCRIPT_DIR=%~dp0
+set PROJECT_ROOT=%SCRIPT_DIR%..
+set VENV_PYTHON=%PROJECT_ROOT%\leetcode\Scripts\python.exe
 
 REM Check if virtual environment exists
 if not exist "%VENV_PYTHON%" (
@@ -25,18 +27,22 @@ REM Check if requirements are installed
 "%VENV_PYTHON%" -c "import mkdocs" >nul 2>&1
 if errorlevel 1 (
     echo Installing dependencies...
+    cd /d "%PROJECT_ROOT%"
     "%VENV_PYTHON%" -m pip install -r requirements.txt
     if errorlevel 1 (
         echo Error: Failed to install dependencies
         exit /b 1
     )
 )
 
+REM Change to project root directory
+cd /d "%PROJECT_ROOT%"
+
 REM Clean build directory if requested
 if "%~1"=="--clean" (
     echo Cleaning build directory...
-    if exist "%BASE_DIR%site" (
-        rmdir /s /q "%BASE_DIR%site"
+    if exist "%PROJECT_ROOT%\site" (
+        rmdir /s /q "%PROJECT_ROOT%\site"
     )
     shift
 )
@@ -73,19 +79,19 @@ if errorlevel 1 (
 
 REM Step 4: Copy mind map HTML files
 echo [4/4] Copying mind map HTML files...
-if exist "%BASE_DIR%docs\pages\mindmaps" (
-    xcopy /E /I /Y "%BASE_DIR%docs\pages\mindmaps" "%BASE_DIR%site\pages\mindmaps" >nul
+if exist "%PROJECT_ROOT%\docs\pages\mindmaps" (
+    xcopy /E /I /Y "%PROJECT_ROOT%\docs\pages\mindmaps" "%PROJECT_ROOT%\site\pages\mindmaps" >nul
 )
-if exist "%BASE_DIR%docs\pages\assets" (
-    xcopy /E /I /Y "%BASE_DIR%docs\pages\assets" "%BASE_DIR%site\pages\assets" >nul 2>nul
+if exist "%PROJECT_ROOT%\docs\pages\assets" (
+    xcopy /E /I /Y "%PROJECT_ROOT%\docs\pages\assets" "%PROJECT_ROOT%\site\pages\assets" >nul 2>nul
 )
 
 echo.
 echo ============================================
 echo Build Complete!
 echo ============================================
 echo.
-echo Output directory: %BASE_DIR%site
+echo Output directory: %PROJECT_ROOT%\site
 echo.
 
 REM Serve locally if requested

build_docs.sh scripts/build_docs.shbuild_docs.sh renamed to scripts/build_docs.sh

@@ -2,14 +2,15 @@
 # ============================================
 #  Build Documentation Locally
 #  Usage: 
-#    ./build_docs.sh              (build only)
-#    ./build_docs.sh --serve      (build and serve locally)
-#    ./build_docs.sh --clean      (clean build directory first)
+#    ./scripts/build_docs.sh              (build only)
+#    ./scripts/build_docs.sh --serve      (build and serve locally)
+#    ./scripts/build_docs.sh --clean      (clean build directory first)
 # ============================================
 
-# Get the directory where the script is located
+# Get script directory and project root
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-VENV_PYTHON="${SCRIPT_DIR}/leetcode/bin/python"
+PROJECT_ROOT="$SCRIPT_DIR/.."
+VENV_PYTHON="$PROJECT_ROOT/leetcode/bin/python"
 
 # Check if virtual environment exists
 if [ ! -f "$VENV_PYTHON" ]; then
@@ -24,17 +25,21 @@ fi
 # Check if requirements are installed
 if ! "$VENV_PYTHON" -c "import mkdocs" 2>/dev/null; then
     echo "Installing dependencies..."
+    cd "$PROJECT_ROOT"
     "$VENV_PYTHON" -m pip install -r requirements.txt
     if [ $? -ne 0 ]; then
         echo "Error: Failed to install dependencies"
         exit 1
     fi
 fi
 
+# Change to project root directory
+cd "$PROJECT_ROOT"
+
 # Clean build directory if requested
 if [ "$1" = "--clean" ]; then
     echo "Cleaning build directory..."
-    rm -rf "${SCRIPT_DIR}/site"
+    rm -rf "$PROJECT_ROOT/site"
     shift
 fi
 
@@ -70,19 +75,19 @@ fi
 
 # Step 4: Copy mind map HTML files
 echo "[4/4] Copying mind map HTML files..."
-if [ -d "${SCRIPT_DIR}/docs/pages/mindmaps" ]; then
-    cp -r "${SCRIPT_DIR}/docs/pages/mindmaps" "${SCRIPT_DIR}/site/pages/" 2>/dev/null || true
+if [ -d "$PROJECT_ROOT/docs/pages/mindmaps" ]; then
+    cp -r "$PROJECT_ROOT/docs/pages/mindmaps" "$PROJECT_ROOT/site/pages/" 2>/dev/null || true
 fi
-if [ -d "${SCRIPT_DIR}/docs/pages/assets" ]; then
-    cp -r "${SCRIPT_DIR}/docs/pages/assets" "${SCRIPT_DIR}/site/pages/" 2>/dev/null || true
+if [ -d "$PROJECT_ROOT/docs/pages/assets" ]; then
+    cp -r "$PROJECT_ROOT/docs/pages/assets" "$PROJECT_ROOT/site/pages/" 2>/dev/null || true
 fi
 
 echo ""
 echo "============================================"
 echo "Build Complete!"
 echo "============================================"
 echo ""
-echo "Output directory: ${SCRIPT_DIR}/site"
+echo "Output directory: $PROJECT_ROOT/site"
 echo ""
 
 # Serve locally if requested