docs(spf): document moq publisher requirements

Merged
MM
2mo ago
+190-0

Summary

Publishers currently have to infer v10's MoQ stream requirements from implementation comments, tests, and protocol drafts. Add a practical publisher guide with a complete camera-resolution ladder, separate screen-share track, and audio catalog, linked from the SPF README and MoQ spec index.

Explain alternate versus render groups, LOC payloads, decoder initialization, timestamps, keyframe alignment, late joins, and live catalog updates. Document the current player limitations and the loopback catalog's missing altGroup, so readers can distinguish a valid stream from functionality not yet exposed by the controls.

Targets mmcc/moq; this PR changes documentation only.

Testing

  • 256 existing tests passed across catalog parsing, source URLs, LOC, codec mapping, catalog resolution, track selection, and subscription handoff.
  • Executed the guide's JSON and selection examples against the source implementation using a temporary validation script: source resolution, camera/screen grouping, decoder configurations, remove/add updates, and selection all passed.
  • Checked all 12 relative links introduced by the guide and README entries, plus git diff --check.
  • Repository pre-commit and commit-message hooks passed. Markdown is excluded from the repository formatter.
  • No live publisher/browser interoperability test was run for this documentation change.

Summary by cubic

Adds a publisher guide for the experimental MoQ player so publishers no longer have to infer v10's stream requirements from implementation comments, tests, and protocol drafts. The guide covers catalog structure, encoding rules, and update flows, and is linked from the SPF README and MoQ spec index. It also documents current player limitations and the loopback catalog's missing altGroup so readers can tell a valid stream from functionality not yet exposed.