docs: add video lessons page with short explainer videos (v5-next backport of #24555)#24601
Draft
AztecBot wants to merge 1 commit into
Draft
docs: add video lessons page with short explainer videos (v5-next backport of #24555)#24601AztecBot wants to merge 1 commit into
AztecBot wants to merge 1 commit into
Conversation
Adds Ciara Nightingale's short Aztec explainer videos to the docs so video-first learners have a home on docs.aztec.network, plus contextual embeds on the concept pages the videos explain. ## What's added **New page: Build → Resources → Video lessons** (`docs-developers/docs/resources/video_lessons.mdx`) Embeds all five videos with a short summary (written from their transcripts) and related-reading links into the relevant written docs: 1. [What is Aztec: Explained in Under 90 Seconds](https://www.youtube.com/watch?v=urcBvo2QJp0) → overview, foundational topics 2. [One Transaction, Two Worlds: Private and Public State on Aztec](https://www.youtube.com/watch?v=MayopgQ1FjI) → transactions, state management 3. [What is Private Composability? An Aztec Explainer](https://www.youtube.com/watch?v=idxRuGQnQKs) → call types, calling other contracts 4. [How Authorization Works on Aztec](https://www.youtube.com/watch?v=VRZVOCdjGZ4) → authwit concepts, aztec.nr authentication witnesses 5. [Get Started on Aztec in Under 60 Seconds](https://www.youtube.com/watch?v=_jgHNdNgFOg) → getting started on a local network **Contextual embeds on related topic pages**, so readers find the videos while exploring the topics they explain (each with a one-line framing sentence and a link back to the video lessons page): | Video | Embedded on | | --- | --- | | What is Aztec | Build → Foundational Topics → Aztec Overview, and Participate landing page | | One Transaction, Two Worlds | Build → Foundational Topics → Transactions | | What is Private Composability | Build → Foundational Topics → Call Types | | How Authorization Works on Aztec | Build → Foundational Topics → Advanced → Authentication Witness, and Build → Aztec.nr → Authentication Witnesses | | Get Started in Under 60 Seconds | Build → Getting Started on Local Network | **Shared `YouTubeEmbed` component** (`src/components/YouTubeEmbed/index.tsx`): responsive 16:9 privacy-enhanced `youtube-nocookie.com` iframe, replacing the copy-pasted inline iframe pattern; used by all new embeds. ## Entry points for video learners - **Landing page** (`docs/index.mdx`): new "Video Lessons" quick link in the Resources grid ("Prefer video? Learn Aztec through short explainers"). The landing page is unversioned, so this goes live on merge and deploy. - **Navbar Resources dropdown** (`docusaurus.config.js`): "Video Lessons" entry under Other Docs, above Glossary. ## Placement rationale The Build docs already have an autogenerated "Resources" sidebar category (community calls, glossary, migration notes), so the video lessons page slots in there with no sidebar changes; it is pinned to the top of Resources via `sidebar_position: 0`. ## Versioning Production serves the versioned snapshots rather than `docs-developers/`, so the video lessons page and all contextual embeds are mirrored into `developer_versioned_docs/version-v4.3.1` (mainnet, default view) and `version-v5.0.0-rc.2` (testnet). Versioned sidebars are autogenerated, so no sidebar JSON changes are needed. The Participate instance is unversioned. ## Validation - `yarn spellcheck` passes (added "Ciara"/"Nightingale"/"Mayopg"/"VRZVO" to `docs-words.txt`; the last two are camelCase fragments of YouTube video IDs) - Full `yarn build` succeeds; verified the built output contains all embeds on every page in the default (mainnet), testnet, and dev versions, plus the landing-page and navbar links (remaining broken-anchor/API-link warnings are pre-existing `aztec_cli_reference` / `state_variables.md` issues, unrelated to this change)
AztecBot
added
ci-draft
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Backport of #24555 ("docs: add video lessons page with short explainer videos", merged to
next2026-07-07) intov5-next, requested by Alejo in Slack.What this adds (same as the original PR)
docs-developers/docs/resources/video_lessons.mdx) embedding Ciara Nightingale's five short Aztec explainer videos with summaries and related-reading links.YouTubeEmbedcomponent (src/components/YouTubeEmbed/index.tsx): responsive 16:9 privacy-enhancedyoutube-nocookie.comiframe.docs/index.mdx) and a navbar Resources → Other Docs entry (docusaurus.config.js).Ciara/Nightingale/Mayopg/VRZVO) indocs-words.txt.How the backport differs from the original
The original mirrored the 7 docs pages into the
version-v4.3.1andversion-v5.0.0-rc.2snapshots. Neither snapshot exists onv5-next— the only one here isversion-v4.3.0— so this backport mirrors the same 7 pages intoversion-v4.3.0instead (the videos are version-agnostic, and the original PR's rationale was that production serves the versioned snapshots). Net: 19 files changed here vs 26 onnext; the per-page content is identical.Verification
317c81c5e8a); the snapshot mirror is the originalv4.3.1copy re-rooted tov4.3.0, and every counterpart page it touches exists there.video_lessons.mdxand all newvideo_lessonscross-links resolve to files present onv5-nextin both the current docs and thev4.3.0snapshot (checked each target on disk).resourcescategory already exists in thev4.3.0snapshot), so no sidebar JSON changes are needed — same as the original.Refs #24555.
Created by claudebox · group:
slackbot