fix: docs deployment (#2528)

<!--
Please read and fill out this form before submitting your PR.

Please make sure you have reviewed our contributors guide before
submitting your
first PR.

NOTE: PR titles should follow semantic commits:
https://www.conventionalcommits.org/en/v1.0.0/
-->

## Overview

<!-- 
Please provide an explanation of the PR, including the appropriate
context,
background, goal, and rationale. If there is an issue with this
information,
please provide a tl;dr and link the issue. 

Ex: Closes #<issue number>
-->

---------

Co-authored-by: tac0turtle <[email protected]>

Author: tac0turtle

.github/workflows/build_docs.yml renamed to .github/workflows/docs_build.yml

@@ -6,10 +6,10 @@ on:
   push:
     branches: [main]
     paths:
-      - "./docs"
+      - "docs/**"
   pull_request:
     paths:
-      - "./docs"
+      - "docs/**"
 
 jobs:
   build:
@@ -22,7 +22,10 @@ jobs:
         with:
           node-version: 20
           cache: yarn # or pnpm / npm
+          cache-dependency-path: docs/yarn.lock
       - name: Install dependencies
         run: yarn install # or pnpm install / npm ci
+        working-directory: docs
       - name: Build with VitePress
         run: yarn build # or pnpm build / npm build
+        working-directory: docs

.github/workflows/deploy_docs.yml renamed to .github/workflows/docs_deploy.yml

@@ -8,7 +8,7 @@ on:
   push:
     branches: [main]
     paths:
-      - "./docs"
+      - "docs/**"
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
@@ -37,15 +37,18 @@ jobs:
         with:
           node-version: 20
           cache: yarn # or pnpm / npm
+          cache-dependency-path: docs/yarn.lock
       - name: Setup Pages
         uses: actions/configure-pages@v5
       - name: Install dependencies
         run: yarn install # or pnpm install / npm ci
+        working-directory: docs
       - name: Build with VitePress
         run: yarn build # or pnpm build / npm build
+        working-directory: docs
       - name: Deploy to GitHub Pages
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./.vitepress/dist
+          publish_dir: ./docs/.vitepress/dist
           cname: ev.xyz

.github/workflows/preview_docs.yml renamed to .github/workflows/docs_preview.yml

@@ -10,7 +10,7 @@ on:
       - synchronize
       - closed
     paths:
-      - "./docs"
+      - "docs/**"
 
 concurrency: preview-${{ github.ref }}
 
@@ -28,17 +28,20 @@ jobs:
         with:
           node-version: 20
           cache: yarn
+          cache-dependency-path: docs/yarn.lock
 
       - name: Install dependencies
         run: yarn install --frozen-lockfile
+        working-directory: docs
 
       - name: Build with Base URL
         run: BASE='/docs-preview/pr-${{ github.event.number }}/' yarn build
+        working-directory: docs
 
       - name: Deploy preview
         uses: rossjrw/pr-preview-action@v1
         with:
-          source-dir: .vitepress/dist
+          source-dir: docs/.vitepress/dist
           deploy-repository: evstack/docs-preview
           token: ${{ secrets.PREVIEW_DEPLOY }}
           preview-branch: main

docs/CLAUDE.md

@@ -23,7 +23,7 @@ This is a **VitePress-based documentation site** for Evolve. Key architectural e
 
 ### Content Organization
 
-```
+```txt
 docs/
 ├── .vitepress/config.ts    # Site configuration, navigation, theme
 ├── blog/                   # Blog posts and announcements

docs/README.md

@@ -1,4 +1,4 @@
-[![Deploy](https://github.com/evstack/ev-node/actions/workflows/deploy.yml/badge.svg)](https://github.com/evstack/docs/actions/workflows/deploy.yml)
+[![Deploy](https://github.com/evstack/ev-node/actions/workflows/deploy.yml/badge.svg)](https://github.com/evstack/ev-node/actions/workflows/deploy.yml)
 
 # Evolve Documentation Site