Why video transcripts belong in the repo, not on a video host
Video hosts come and go. Loom changes pricing, internal Confluence migrations break embed links, YouTube videos get deleted by their original uploader. Code repositories outlive video hosts by orders of magnitude. A transcribed walkthrough committed to docs/ becomes part of the repo's history — it's there in two years when a contributor checks out an old commit, it's grep-able from the command line, and it shows up in GitHub's repo search.
The contributor onboarding workflow
Maintainers record a "tour of the codebase" video once per major refactor. Convert it to Markdown, commit as docs/contributing/codebase-tour.md, link from CONTRIBUTING.md. New contributors can read the structured transcript in 8 minutes instead of watching a 25-minute video at 1x — and they can quote specific sections in their first PRs without re-watching to find the relevant moment.
Pair with PDF spec docs (PDF for GitHub), web architecture references (URL for GitHub), and recorded design discussions (Audio for GitHub) for a complete contributor knowledge base.
Release notes from launch videos
For products that ship via launch video (typical in dev tools, OSS frameworks), convert the launch demo, extract the per-feature sections from the structured Markdown, paste into RELEASE_NOTES.md. The transcript becomes the source of truth for the launch — same content, indexed and searchable, no video hosting dependency.