Replace duplicated Mermaid content with file reference and update regeneration instructions

Co-authored-by: leofang <5534781+leofang@users.noreply.github.com>

Author: Copilot

CONTRIBUTING.md

@@ -95,84 +95,7 @@ The CUDA Python project uses a comprehensive CI pipeline that builds, tests, and
 
 ![CUDA Python CI Pipeline Flow](ci/ci-pipeline.svg)
 
-Alternative Mermaid diagram representation:
-
-```mermaid
-flowchart TD
-    %% Trigger Events
-    subgraph TRIGGER["🔄 TRIGGER EVENTS"]
-        T1["• Push to main branch<br/>• Push to pull-request/* branches"]
-        T2["• Pull request<br/>• Manual workflow dispatch"]
-        T1 --- T2
-    end
-
-    %% Build Stage
-    subgraph BUILD["🔨 BUILD STAGE"]
-        subgraph BUILD_PLATFORMS["Parallel Platform Builds"]
-            B1["linux-64<br/>(Self-hosted)"]
-            B2["linux-aarch64<br/>(Self-hosted)"] 
-            B3["win-64<br/>(GitHub-hosted)"]
-        end
-        BUILD_DETAILS["• Python versions: 3.9, 3.10, 3.11, 3.12, 3.13<br/>• CUDA version: 13.0.0 (build-time)<br/>• Components: cuda-core, cuda-bindings,<br/>  cuda-pathfinder, cuda-python"]
-    end
-
-    %% Artifact Storage
-    subgraph ARTIFACTS["📦 ARTIFACT STORAGE"]
-        subgraph GITHUB_ARTIFACTS["GitHub Artifacts"]
-            GA1["• Wheel files (.whl)<br/>• Test artifacts<br/>• Documentation<br/>(30-day retention)"]
-        end
-        subgraph GITHUB_CACHE["GitHub Cache"]
-            GC1["• Mini CTK cache"]
-        end
-    end
-
-    %% Test Stage
-    subgraph TEST["🧪 TEST STAGE"]
-        subgraph TEST_PLATFORMS["Parallel Platform Tests"]
-            TS1["linux-64<br/>(Self-hosted)"]
-            TS2["linux-aarch64<br/>(Self-hosted)"]
-            TS3["win-64<br/>(GitHub-hosted)"]
-        end
-        TEST_DETAILS["• Download wheels from artifacts<br/>• Test against multiple CUDA runtime versions<br/>• Run Python unit tests, Cython tests, examples"]
-        ARTIFACT_FLOWS["Artifact Flows:<br/>• cuda-pathfinder: main → backport<br/>• cuda-bindings: backport → main"]
-    end
-
-    %% Release Pipeline
-    subgraph RELEASE["🚀 RELEASE PIPELINE"]
-        subgraph RELEASE_STAGES["Sequential Release Steps"]
-            R1["Validation<br/>• Artifact integrity<br/>• Git tag verification"]
-            R2["Publishing<br/>• PyPI/TestPyPI<br/>• Component or all releases"]
-            R3["Documentation<br/>• GitHub Pages<br/>• Release notes"]
-            R1 --> R2 --> R3
-        end
-        RELEASE_DETAILS["• Manual workflow dispatch with run ID<br/>• Supports individual component or full releases"]
-    end
-
-    %% Main Flow
-    TRIGGER --> BUILD
-    BUILD --> ARTIFACTS
-    ARTIFACTS --> TEST
-    TEST --> RELEASE
-
-    %% Artifact Flow Arrows (Cache Reuse)
-    GITHUB_CACHE -.->|"mini CTK reuse"| BUILD
-    
-    %% Artifact Flow Arrows (Wheel Fetch)
-    GITHUB_ARTIFACTS -.->|"wheel fetch"| RELEASE
-
-    %% Styling
-    classDef triggerStyle fill:#e8f4fd,stroke:#2196F3,stroke-width:2px,color:#1976D2
-    classDef buildStyle fill:#f3e5f5,stroke:#9C27B0,stroke-width:2px,color:#7B1FA2
-    classDef artifactStyle fill:#fff3e0,stroke:#FF9800,stroke-width:2px,color:#F57C00
-    classDef testStyle fill:#e8f5e8,stroke:#4CAF50,stroke-width:2px,color:#388E3C
-    classDef releaseStyle fill:#ffebee,stroke:#f44336,stroke-width:2px,color:#D32F2F
-
-    class TRIGGER,T1,T2 triggerStyle
-    class BUILD,BUILD_PLATFORMS,B1,B2,B3,BUILD_DETAILS buildStyle
-    class ARTIFACTS,GITHUB_ARTIFACTS,GITHUB_CACHE,GA1,GC1 artifactStyle
-    class TEST,TEST_PLATFORMS,TS1,TS2,TS3,TEST_DETAILS,ARTIFACT_FLOWS testStyle
-    class RELEASE,RELEASE_STAGES,R1,R2,R3,RELEASE_DETAILS releaseStyle
-```
+Alternative Mermaid diagram representation ([ci/ci-pipeline.mmd](ci/ci-pipeline.mmd)):
 
 ### Pipeline Execution Details
 

ci/.ci-pipeline-regen.txt

@@ -52,18 +52,47 @@ This file contains the prompt and requirements for regenerating ci-pipeline.svg
 - Additional artifact flow arrows (dashed, orange #FF9800):
   - From GitHub Cache (mini CTK) back to Build Stage with "mini CTK reuse" label
   - From GitHub Artifacts (wheels) to Release Pipeline with "wheel fetch" label
-- Arrow marker definition with hand-drawn style
+- Arrow marker definition with hand-drawn style (orange arrow heads, not black)
 - Use stroke-dasharray="5,3" for artifact flow arrows
 
+## Critical Arrow Positioning Requirements (UPDATED)
+**IMPORTANT**: Arrows must NOT overlap with stage boxes. Ensure proper clearance:
+
+1. **Mini CTK reuse arrow** (GitHub Cache → Build Stage):
+   - Arrow endpoint Y coordinate must be BELOW the Build Stage box edge (y=292)
+   - Use y=295 or greater for the endpoint to ensure no overlap
+   - Position "mini CTK reuse" text to the RIGHT of the arrow (not left) for less visual clutter
+   - Text color should be orange (#FF9800) to match arrow
+
+2. **Wheel fetch arrow** (GitHub Artifacts → Release Pipeline):
+   - Arrow endpoint Y coordinate must be ABOVE the Release Pipeline box edge (y=652)
+   - Use y=645 or smaller for the endpoint to provide proper margin
+   - Position "wheel fetch" text between Test Stage and Release Pipeline boxes
+   - Text should be to the LEFT of the arrow for better spacing
+
+## Font Size Requirements (UPDATED)
+- ALL text labels must use consistent 12pt font size for readability
+- No 9pt text - this is too small and hard to read
+- Title: 16pt, Stage headers: 14pt, All other text: 12pt
+
 ## Key Features
 - All boxes use rough, hand-drawn paths (not perfect rectangles)
 - Text should be properly sized and positioned within boxes
 - Platform boxes within each stage should be clearly separated
 - Maintain consistent spacing and alignment
-- Use appropriate font sizes: 16pt title, 14pt stage headers, 12pt platform names, 11pt details, 9-10pt smaller text
+- Orange arrow heads must match the orange arrow color
 
 ## Text Positioning
 - Use text-anchor="middle" for centered headers
 - Use text-anchor="start" for left-aligned bullet points
 - Ensure all text fits within their enclosing boxes
-- Use transforms for angled text labels on artifact flow arrows
+- Use transforms for angled text labels on artifact flow arrows
+- Artifact flow arrow text positioning is critical - follow positioning requirements above
+
+## Recent Manual Adjustments Applied
+- Fixed arrow endpoint positioning to prevent overlap with stage boxes
+- Moved mini CTK reuse arrow endpoint from y=285 to y=295
+- Moved wheel fetch arrow endpoint from y=650 to y=645  
+- Repositioned text labels for better visual separation
+- Standardized all text to 12pt font size for consistency
+- Changed arrow heads from black to orange to match arrow color