fix: add documents link

Author: stepanLav

.github/workflows/pr-preview-cleanup.yml

@@ -1,3 +1,4 @@
+# Documentation: docs/workflow/cloudflare-pr-preview.md
 name: Cleanup PR Preview
 
 on:

.github/workflows/pr-preview-deploy.yml

@@ -1,3 +1,4 @@
+# Documentation: docs/workflow/cloudflare-pr-preview.md
 name: Deploy PR Preview
 
 on:

docs/workflow/cloudflare-pr-preview.md

@@ -1,103 +1,67 @@
-# Cloudflare Pages PR Preview Deployment Guide
+# Cloudflare Pages PR Preview Deployment
 
-This guide explains how to set up and use Cloudflare Pages for automatic PR preview deployments of the Nova Spektr application.
+Automatic PR preview deployments for the Nova Spektr renderer application using Cloudflare Pages.
 
-## Overview
+## Quick Reference
 
-The PR preview system automatically builds and deploys the renderer application to Cloudflare Pages whenever a pull request is opened or updated. This allows developers and reviewers to test changes in a live environment before merging.
-
-### Architecture
-
-- **Build Process**: The GitHub Actions workflow builds the renderer using `pnpm renderer:staging`
-- **Deployment**: Static assets are deployed to Cloudflare Pages using Wrangler CLI
-- **Project-per-PR**: Each PR gets its own Cloudflare Pages project: `nova-spektr-pr-{pr_number}`
-- **Serving**: Cloudflare Pages serves the static files with proper caching and security headers automatically
-- **URL Format**: Each PR gets a unique preview URL based on the project name
+- **Workflow Files**: 
+  - [Deploy Workflow](/.github/workflows/pr-preview-deploy.yml)
+  - [Cleanup Workflow](/.github/workflows/pr-preview-cleanup.yml)
+- **Triggers**: PR opened, updated, or reopened (deploy) | PR closed (cleanup)
+- **Project Naming**: `nova-spektr-pr-{pr_number}`
+- **Build Output**: `release/build/`
 
 ## How It Works
 
-### Build Process
-
-The workflow runs the following steps:
-
-```bash
-pnpm clean:build          # Clean previous builds
-pnpm renderer:staging     # Build renderer with staging config
-pnpm postbuild:staging    # Run post-build scripts
-```
-
-The build output is placed in `release/build/` directory, which contains:
-- `index.html` - Main HTML file
-- JavaScript bundles (`.js`, `.mjs`)
-- CSS files
-- Static assets (images, fonts, etc.)
-
-### Deployment Process
-
-1. **Pages Deployment**: Uses `wrangler pages deploy` command with:
-   - Project name: `nova-spektr-pr-{pr_number}` (unique per PR)
-   - Static assets: Served from `release/build/` directory
+### Deployment Flow
 
-2. **Automatic Serving**: Cloudflare Pages automatically:
-   - Serves static files with correct MIME types
-   - Handles SPA routing (serves `index.html` for non-file paths)
-   - Applies security headers
-   - Caches static assets efficiently
+1. **Build**: Runs `pnpm clean:build`, `pnpm renderer:staging`, and `pnpm postbuild:staging`
+2. **Project Creation**: Creates Cloudflare Pages project if it doesn't exist
+3. **Deploy**: Deploys `release/build/` to Cloudflare Pages
+4. **Notification**: Posts preview URL as PR comment
 
-### URL Structure
+### Cleanup Flow
 
-Each PR gets its own Cloudflare Pages project:
-- **Project Name**: `nova-spektr-pr-{pr_number}` (e.g., `nova-spektr-pr-123`)
-- **Preview URL**: Automatically generated by Cloudflare Pages for the project
-- The URL is automatically commented on the PR after successful deployment
-- URL format: `https://nova-spektr-pr-{pr_number}.pages.dev` or similar
+When a PR is closed (merged or closed):
+- Automatically deletes the Cloudflare Pages project `nova-spektr-pr-{pr_number}`
+- Removes all associated deployments and builds
+- Runs silently (no PR comment)
 
-### Cleanup Process
+## Project Details
 
-When a PR is closed (merged or closed without merging):
-1. A cleanup job automatically runs
-2. The entire Cloudflare Pages project `nova-spektr-pr-{pr_number}` is deleted
-3. This removes all deployments, builds, and project data associated with the PR
-4. The cleanup job completes silently (no PR comment needed)
+- **Project Name Format**: `nova-spektr-pr-{pr_number}` (e.g., `nova-spektr-pr-123`)
+- **Preview URL**: Automatically generated by Cloudflare Pages (e.g., `https://nova-spektr-pr-123.pages.dev`)
+- **URL Delivery**: Posted as a comment on the PR after successful deployment
+- **SPA Support**: Cloudflare Pages automatically handles SPA routing
 
-## Usage
+## Monitoring
 
-### Automatic Deployment
-
-The workflow runs automatically when:
-- A new pull request is opened
-- New commits are pushed to an existing PR
-- A PR is reopened
-
-### Automatic Cleanup
-
-The workflow automatically cleans up when:
-- A PR is closed (merged or closed without merging)
-- All deployments for the PR branch are deleted
-
-## Maintenance
-
-### Automatic Cleanup
-
-PR preview projects are automatically deleted when PRs are closed. No manual intervention is required.
+- **GitHub Actions**: Check workflow runs for deployment status
+- **PR Comments**: Preview URLs are automatically posted
+- **Cloudflare Dashboard**: View projects at Workers & Pages → Pages
 
-### Manual Cleanup (if needed)
+## Manual Operations
 
-If you need to manually clean up a project:
+### Delete a Project Manually
 
-1. Go to Cloudflare Dashboard → **Workers & Pages** → **Pages**
-2. Find the project named `nova-spektr-pr-{pr_number}`
-3. Delete the project manually if needed
+**Via Cloudflare Dashboard:**
+1. Go to **Workers & Pages** → **Pages**
+2. Find project `nova-spektr-pr-{pr_number}`
+3. Delete the project
 
-Or use Wrangler CLI:
+**Via Wrangler CLI:**
 ```bash
 wrangler pages project delete nova-spektr-pr-{pr_number}
 ```
 
-### Monitoring
+## Troubleshooting
 
-- **Cloudflare Dashboard**: View Pages projects, deployments, and logs
-- **GitHub Actions**: Check workflow runs for deployment status
-- **PR Comments**: Preview URLs are automatically posted to PRs
+**Deployment fails:**
+- Check GitHub Actions workflow logs
+- Verify `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID` secrets are set
+- Ensure build completes successfully
 
-Each PR appears as a separate project in Cloudflare Dashboard, making it easy to identify and monitor individual PR previews.
+**Preview URL not working:**
+- Wait a few minutes for DNS propagation
+- Check Cloudflare Dashboard for deployment status
+- Verify the project exists in Cloudflare Pages