Skip to content

docs(cli): list --format and the 24-worker cap in docs rendering - #7716

Merged
miguel-heygen merged 1 commit into
heygen-com:mainfrom
shurtado24:docs/rendering-workers-format
Nov 14, 2026
Merged

miguel-heygen merged 1 commit into
heygen-com:mainfrom
shurtado24:docs/rendering-workers-format

Conversation

@shurtado24

Copy link
Copy Markdown
Contributor

What

hyperframes docs rendering now lists --format and --gif-loop, and gives the real --workers range.

Why

The page said workers run 1-8, but the engine accepts up to 24. It also never mentioned --format, so readers couldn't learn that render can also output webm, mov, gif, png-sequence and hls.

Related work

Fixes #7668

How

packages/cli/src/docs/rendering.md only:

  • --workers: 1-24 or auto. The CLI accepts any positive integer (commands/render/plan.ts), and the engine clamps an explicit value to ABSOLUTE_MAX_WORKERS = 24 (packages/engine/src/services/parallelCoordinator.ts). So the line says higher values are capped, not rejected.
  • --format and --gif-loop: wording and default (mp4) taken from their option definitions in packages/cli/src/commands/render.ts.
  • The intro line no longer says renders are MP4 only.

Test plan

  • Unit tests added/updated: not needed, docs-only. commands/docs.test.ts passes (3 tests).
  • Manual testing performed: ran hyperframes docs rendering from source and checked that the new lines read cleanly in the terminal output.
  • Documentation updated (if applicable): this PR is the documentation change.
  • Comments follow CONTRIBUTING.md "Comments": no code comments added.

`hyperframes docs rendering` said workers run 1-8, but the engine
clamps an explicit value to 24, and it never mentioned --format or
--gif-loop. The options now match render.ts and the engine limit.

Fixes heygen-com#7668

@miguel-heygen miguel-heygen left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Docs match the code on main: the engine caps workers at ABSOLUTE_MAX_WORKERS = 24 (parallelCoordinator.ts), and --format / --gif-loop wording and default come from their option definitions in commands/render.ts. CI green.

@miguel-heygen
miguel-heygen added this pull request to the merge queue Nov 14, 2026
Merged via the queue into heygen-com:main with commit 3e69d0d Nov 14, 2026
70 checks passed
@heygengenesis heygengenesis Bot mentioned this pull request Nov 14, 2026
1 of 2 tasks
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.

docs: hyperframes docs rendering lists 1-8 workers and never mentions --format

2 participants