Skip to content

docs: regenerate the showcase in the didactic style (dogfooded) - #13

Merged
HeyRenan merged 1 commit into
mainfrom
docs-showcase-didactic
Jul 6, 2026
Merged

docs: regenerate the showcase in the didactic style (dogfooded)#13
HeyRenan merged 1 commit into
mainfrom
docs-showcase-didactic

Conversation

@HeyRenan

@HeyRenan HeyRenan commented Jul 6, 2026

Copy link
Copy Markdown
Owner

The top-of-README showcase was rendered under the pre-1.4.0 "cinematic" docs (a feature-cram "one take, every feature"). Regenerated with Showreel itself against the bundled demo page, now in the didactic style the plugin teaches: one real deploy flow (read the pipeline → health gate blocks → auto-rollback → re-run → ship), one focus per beat, motion in service of the step. Lighter too (mp4 13.6MB → 6.2MB).

🤖 Generated with Claude Code

The old top-of-README showcase was rendered under the pre-1.4.0 "cinematic"
docs — a feature-cram "one take, every feature". Regenerated with Showreel
itself against the bundled demo page, now in the didactic style the plugin
teaches: one real deploy flow (read the pipeline -> health gate blocks ->
auto-rollback -> re-run -> ship), one focus per beat, motion in service of
the step. Lighter too (mp4 13.6MB -> 6.2MB, poster 158KB -> 118KB).

- assets/showcase.mp4 + assets/showcase-poster.png regenerated (PLACE clean).
- README + pt-BR caption rewritten to match the flow shown.
@HeyRenan
HeyRenan merged commit d8ad3ac into main Jul 6, 2026
@HeyRenan
HeyRenan deleted the docs-showcase-didactic branch July 6, 2026 18:54
HeyRenan added a commit that referenced this pull request Jul 6, 2026
PR #13 shipped the new didactic showcase.mp4 but left the OLD ~90-step
feature-cram roster committed as assets-src/showcase-steps.json — so the mp4 and
its source were out of sync, and re-rendering "the same command" (README's
promise) would reproduce the old reel, not the shipped one. This class is exactly
"will it break again?": fix the OUTPUT but not the SOURCE and it regresses on the
next render.

Replace assets-src/showcase-steps.json with the fixed 19-step held-camera flow
(byte-identical to the roster that rendered the shipped assets/showcase.mp4).
Audit-clean (0 zoom-churn, no off-screen/anchor errors). Now source == output;
re-rendering reproduces the fixed, churn-free reel.

Render:
  node showreel/scripts/rec.mjs \
    "file://$PWD/assets-src/demo/index.html?gate=fail" \
    --steps assets-src/showcase-steps.json assets/showcase.mp4 \
    --fps 30 --width 1600 --height 900
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant