Skip to content

Commit 2bc3c0c

Browse files
TMHSDigitalclaude
andcommitted
docs(showcase): say what the showcase proves, not only what it is not
The README listed "76 showcase pieces" next to skills and rules and described them only as "budget-conformance props ... not examples", so a first-time visitor could read the repo as an asset pack. The README overview, the examples section and showcase/README.md now say why the showcase exists: each piece is one headless script that runs the pipeline the skills teach (cleanup, bake, LODs, collider, engine export) end to end and asserts measured budgets on every LTS, so it is evidence that the skills compose. The landing page already framed it this way. Closes #383 Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent e217c8a commit 2bc3c0c

2 files changed

Lines changed: 9 additions & 2 deletions

File tree

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ The content is consumed by AI coding agents reading these files directly from a
5252
| **Templates** | A working Extensions Platform add-on starter, a headless batch script starter, and a GLB-in engine-ready asset pipeline |
5353
| **Snippets** | 27 small standalone Python files demonstrating canonical patterns |
5454
| **Examples** | Runnable headless scripts under [`examples/`](examples/). Each asserts an API contract and exits non-zero on failure. |
55-
| **Showcase** | Budget-conformance props under [`showcase/`](showcase/). Not examples. Conventions: [`showcase/README.md`](showcase/README.md) |
55+
| **Showcase** | Proof that the skills compose: each piece under [`showcase/`](showcase/) is one headless Python script that builds a game prop and runs the whole asset pipeline (cleanup, high-to-low bake, LODs, convex collider, engine export), asserting measured budgets on every LTS. Not API examples. Conventions: [`showcase/README.md`](showcase/README.md) |
5656

5757
## Quick start
5858

@@ -130,7 +130,7 @@ per-script exit-code model, are in
130130

131131
## Examples and showcase
132132

133-
**64 examples** in [`examples/`](examples/) are runnable, self-checking scripts: each asserts one API contract, carries a falsifier, and runs headless on Blender 5.2 LTS and 4.5 LTS in the `blender-smoke` workflow (5.1 on the weekly cron or by manual dispatch). Those whose contract is visible also render a still. **76 showcase pieces** in [`showcase/`](showcase/) are game props held to measured budgets (triangle counts, colliders, materials, real-world size); they are not examples. Conventions: [`showcase/README.md`](showcase/README.md).
133+
**64 examples** in [`examples/`](examples/) are runnable, self-checking scripts: each asserts one API contract, carries a falsifier, and runs headless on Blender 5.2 LTS and 4.5 LTS in the `blender-smoke` workflow (5.1 on the weekly cron or by manual dispatch). Those whose contract is visible also render a still. **76 showcase pieces** in [`showcase/`](showcase/) exist to show the skills working together at production scale: each is a single headless script that models a game prop, then runs it through the same cleanup, bake, LOD, collider and export steps the skills teach, and fails if a measured budget (triangle counts, colliders, materials, real-world size) is missed. They are not API examples. Conventions: [`showcase/README.md`](showcase/README.md).
134134

135135
Browse both, with filters, full-size renders and each script's README, in the **[gallery](https://tmhsdigital.github.io/Blender-Developer-Tools/gallery/)**.
136136

‎showcase/README.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,13 @@
22

33
Budget-conformance props. **Not examples.**
44

5+
**Why it is here:** examples prove one API contract each; the showcase proves
6+
the contracts compose. Every piece is one headless Python script that models
7+
a game prop and runs it through the pipeline the skills teach
8+
(`ai-mesh-cleanup`, `bake-high-to-low`, LOD decimation, a convex collider,
9+
`engine-export-presets`), then asserts measured budgets on 4.5 LTS, 5.1 and
10+
5.2 LTS. If a skill's advice were wrong, a piece here would fail.
11+
512
An example witnesses one API contract and carries a falsifier that makes a
613
real assertion fail. A recognizable crate witnesses no API contract.
714
Forcing one into `examples/` produces a vacuous check. Showcase pieces

0 commit comments

Comments
 (0)