Skip to content

sglang-explainer-video: one cover design per video, ending links to source and cookbook - #148

Merged
BBuf merged 1 commit into
mainfrom
explainer-per-video-cover-ending-links
Nov 15, 2026
Merged

BBuf merged 1 commit into
mainfrom
explainer-per-video-cover-ending-links

Conversation

@BBuf

@BBuf BBuf commented Nov 15, 2026

Copy link
Copy Markdown
Owner

Why

Two pieces of feedback on the latest explainer videos:

  • The covers looked alike. The brand-orange template ran for 19 videos, and the graphite design that replaced it ran for five more. Each video should get a cover designed from its own content, and its title and description should be written for it as well.
  • The ending should point viewers at SGLang's source and cookbook, not only at the project home pages.

What changes

Cover: one design per video

  • house-style.md §Cover: design from the content, differ from each of the last five covers in at least three of ground / accent / type / composition / illustration, keep the hook as the largest line and the small SGLang PR 讲解 · #N tag.
  • scripts/cover_kit.py: turns a project's css(width, dy), body(prefix) and reveal steps into the animated frame 1 and both stills; cover_kit.py wall tiles the newest covers so a new design can be compared with them.
  • references/cover-log.md: what each cover so far used.
  • The brand-orange make_cover.py template stays for a video whose user asks for the series look.

Ending links

  • The last frame's block (assets/brand/follow-strip.html, both themes) gains a links card above the follow strip: the source the video explains, and the cookbook or docs page to open next.
  • check_frames.mjs requires the card with one link of each kind; check_links.py opens every link on the last frame and in the publish texts.

Titles and descriptions

  • publishing.md §Title and description: written from each video's hook, no fixed prefix, shaped by the story, closing with the same links as the last frame.
  • publish_check.py fails an SGLang text without the source and cookbook / docs links.

Validation

  • pytest tests/test_explainer_*.py: 55 passed (new: cover kit, link extraction, link checks in publish texts).
  • pre-commit run on the changed files: all hooks pass.
  • Used end to end on two videos (PR 47013 and PR 49263): new covers built with cover_kit.py, last frames carry the links card, check_frames.mjs passes on both and fails an older project without the card, and check_links.py opened all six links of each video.

🤖 Generated with Claude Code

…ource and cookbook

- Cover: every video gets its own design, derived from its content and checked
  against the recent covers (cover_kit.py wall, references/cover-log.md). The
  brand-orange template stays for videos whose user asks for the series look.
  cover_kit.py writes the animated frame 1 and both stills from a project's
  css() / body() / reveal steps.
- Ending: the last frame now carries a links card above the follow strip, with
  the source the video explains and the cookbook or docs page to open next.
  check_frames.mjs requires it; check_links.py opens every link shown.
- Publishing: titles and descriptions are written from each video's own hook
  and close with the same links; publish_check.py checks for them.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@BBuf
BBuf merged commit eb95c1b into main Nov 15, 2026
1 check passed
@BBuf
BBuf deleted the explainer-per-video-cover-ending-links branch November 15, 2026 04:17
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