> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venture.caplia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding a new guide

> How to publish a video guide on this site (internal)

<Warning>
  Internal how-to for the Caplia team — remove this page from `docs.json` before making the Guides tab customer-only, or leave it as the team recipe.
</Warning>

Each guide is one MDX file in the `guides/` folder with a video at the top. Five minutes, no code knowledge needed.

<Steps>
  <Step title="Record the video">
    Loom, YouTube (unlisted), or Mux all work: anything that gives you an embed URL. Keep guides under \~5 minutes; one task per guide.
  </Step>

  <Step title="Copy an existing guide">
    Duplicate `guides/welcome-tour.mdx`, rename the file to your topic in kebab-case (e.g. `guides/creating-a-cohort-channel.mdx`), and update the frontmatter `title`, `description`, and `icon`.
  </Step>

  <Step title="Paste your video embed">
    Replace the placeholder with your embed:

    ```jsx Loom theme={null}
    <iframe
      src="https://www.loom.com/embed/YOUR_VIDEO_ID"
      frameborder="0"
      allowfullscreen
      style={{ width: '100%', aspectRatio: '16 / 9', borderRadius: '12px' }}
    ></iframe>
    ```

    ```jsx YouTube theme={null}
    <iframe
      src="https://www.youtube.com/embed/YOUR_VIDEO_ID"
      frameborder="0"
      allowfullscreen
      style={{ width: '100%', aspectRatio: '16 / 9', borderRadius: '12px' }}
    ></iframe>
    ```

    Optionally add 3-5 written steps below the video so the guide works without sound.
  </Step>

  <Step title="Register the page">
    Add the page path to the **Guides** tab in `docs.json` (`"guides/creating-a-cohort-channel"`), and add a `<Card>` for it on `guides/index.mdx` so it shows in the hub.
  </Step>

  <Step title="Open a PR and merge">
    All changes go through a pull request: `main` is protected and publishes the live site the moment a PR merges. Every PR runs a **Validate Docs** check (links and style); the merge button unlocks when it's green. If it fails, the check names exactly what to fix.
  </Step>
</Steps>

<Tip>
  Ask Claude to do steps 2–5 for you: "add a guide called *Creating a cohort channel* with this Loom link" is enough. If you're using Claude with the GitHub connector (Cowork), tell it to read `AGENTS.md` in the repo root first: it holds the style rules the checks enforce, then have it create a branch, commit the files, and open the PR for you.
</Tip>