Commit e054ef0
committed
docs(build): explain why AI Models and SEA don't use directory caching
Expand Pattern 3 documentation to clearly explain why directory caching
is not used for AI Models and SEA builds.
**Added explanations:**
AI Models:
- Single-pass conversion (PyTorch → ONNX → Quantize)
- No incremental compilation (can't resume partway)
- Temp files deleted immediately
- 10-15 min build time (not worth cache overhead)
SEA:
- Just JS bundling + injection (~30 seconds total)
- Uses pre-built Node.js (no compilation)
- Cache download > rebuild time
**Added decision criteria:**
When directory caching IS valuable:
- Slow compilation (>5 minutes)
- Can fail partway through
- Reusable intermediate state
- Resume faster than rebuild
When directory caching is NOT valuable:
- No compilation (scripts/bundling)
- Already fast (<1 minute)
- No reusable intermediate state
- Cache overhead > time saved
This clarifies why the unified strategy uses different caching approaches
for different build types.1 parent e991ee7 commit e054ef0
1 file changed
+28
-0
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
114 | 114 | | |
115 | 115 | | |
116 | 116 | | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
117 | 145 | | |
118 | 146 | | |
119 | 147 | | |
| |||
0 commit comments