Skip to content

docs: scaffold Video Tutorials page #322

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
aaitor wants to merge 1 commit into
base: main
Choose a base branch
from
+154 −0
Draft

docs: scaffold Video Tutorials page #322

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@
"getting-started/overview",
"getting-started/core-concepts",
"getting-started/ai-agent-purchase",
"getting-started/video-tutorials",

@r-marques r-marques Aug 27, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

💡 NIT — The page is reachable only from the sidebar — nothing links to it

This nav entry is the sole reference to /getting-started/video-tutorials anywhere in the repo; no page links to it. That's normal for a brand-new page, but it means the tutorials are discoverable only by someone already scanning the sidebar.

A line from getting-started/overview.mdx — the page directly above this one in the same Learn group — would put it in the reading flow for someone arriving at the docs for the first time, which is precisely the audience for a "first login" video. Worth doing when the first real recording lands, if not now.

🤖 pr-review-toolkit · reviewer-verified · medium

"products/payments/faq",
"products/payments/certifications",
{
Expand Down
153 changes: 153 additions & 0 deletions getting-started/video-tutorials.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,153 @@
---
title: "Video Tutorials"
description: "Short, screen-recorded walkthroughs of the Nevermined App — from your first login to running an organization, for both sellers and buyers."

Check warning on line 3 in getting-started/video-tutorials.mdx

View check run for this annotation

Mintlify / Mintlify Validation (neverminedag) - vale-spellcheck

getting-started/video-tutorials.mdx#L3 

Did you really mean 'walkthroughs'?

Check warning on line 3 in getting-started/video-tutorials.mdx

View check run for this annotation

Mintlify / Mintlify Validation (neverminedag) - vale-spellcheck

getting-started/video-tutorials.mdx#L3 

Did you really mean 'Nevermined'?
icon: "circle-play"
---

Prefer to watch instead of read? These short walkthroughs (1–3 minutes each) take you through the Nevermined App screen by screen — signing up, selling your first agent, buying and paying as an agent, and running an organization.

Check warning on line 7 in getting-started/video-tutorials.mdx

View check run for this annotation

Mintlify / Mintlify Validation (neverminedag) - vale-spellcheck

getting-started/video-tutorials.mdx#L7 

Did you really mean 'walkthroughs'?

Check warning on line 7 in getting-started/video-tutorials.mdx

View check run for this annotation

Mintlify / Mintlify Validation (neverminedag) - vale-spellcheck

getting-started/video-tutorials.mdx#L7 

Did you really mean 'Nevermined'?

<Note>
We're recording this library now. Sections marked **🎬 Coming soon** don't have a video yet — the written guide linked from each one covers the same flow in the meantime.

@r-marques r-marques Aug 27, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

🟡 SHOULD FIX — The Note promises a written guide for every entry — 7 of 19 have none

This sentence tells the reader that for anything marked Coming soon, "the written guide linked from each one covers the same flow in the meantime". That holds for most of the page, but not all of it.

Counted on this file: 19 <Accordion> entries, 12 carry a Written guide link, 7 do not:

Line Accordion
39 Sign up & log in for the first time
43 Sandbox vs Live
59 Seller first steps: the dashboard
63 Connect Stripe
89 Buyer first steps: dashboard & wallet
108 See your payment requests
134 Org plans & org agents

For those seven a reader gets a title, one sentence, and "🎬 Coming soon" — nothing to click and nothing to read. Since every entry on the page is currently a placeholder, this sentence is the only thing standing between the reader and a dead end, so it's worth it being exactly true.

Two ways to close it, either fine: soften the claim ("where a written guide exists, it's linked below"), or add links for the seven. I looked for existing targets for the gaps and did not find dedicated pages for them — Connect Stripe and Sandbox vs Live appear only as passing mentions inside other guides (e.g. getting-started/overview.mdx, agents-guide/get-api-key.mdx), not as pages I'd send a reader to. So softening the sentence is probably the cheaper fix, unless you know of targets I missed.

🤖 pr-review-toolkit · reviewer-verified · high

</Note>

{/*

@r-marques r-marques Aug 27, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

✅ NICE — Avoids both of this repo's classic deploy-breakers, and the links actually resolve

Two traps sidestepped that regularly bite this repo:

  1. MDX comment style — this block is {/* … */}. An HTML comment (<!-- … -->) here would fail the Mintlify deploy, and the maintainer instructions inside it are exactly the kind of content that tempts one.
  2. docs.json as text — the change is a single added line, not a json.load/json.dump round-trip that reformats ~1300 lines and hides the real edit in the noise.

And the links hold up: I ran mintlify broken-links against this branch's tree and it returned success — no broken links found, with all 12 internal links independently confirmed to resolve to real files. The run also completed rather than aborting, which rules out a bare <placeholder> voiding the check.

The maintainer block is a genuinely good idea too — the next person to add a video doesn't have to reverse-engineer the embed markup from a rendered page.

🤖 pr-review-toolkit · reviewer-verified · high

MAINTAINER — how to publish a recorded video:
1. Upload to the Nevermined YouTube channel and copy its ID (the part after `watch?v=`).

Check warning on line 15 in getting-started/video-tutorials.mdx

View check run for this annotation

Mintlify / Mintlify Validation (neverminedag) - vale-spellcheck

getting-started/video-tutorials.mdx#L15 

Did you really mean 'Nevermined'?
2. In the matching <Accordion> below, replace the "🎬 Coming soon" <Note> with:

<Frame>
<iframe
width="100%"
height="420"
src="https://www.youtube.com/embed/VIDEO_ID"
title="VIDEO TITLE"
frameborder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
allowfullscreen
></iframe>
Comment on lines +23 to +27
</Frame>

3. Keep the one-line description and the "Written guide" link.
This page is the single source of truth for video URLs — the in-app and modal embeds reuse them.
*/}

## Getting started (everyone)

The first-run basics — the same for sellers and buyers.

<AccordionGroup>
<Accordion title="Sign up & log in for the first time" icon="right-to-bracket">
Create your account with email or a Google account, verify it, and land in the app.
<Note>🎬 Coming soon</Note>
</Accordion>
<Accordion title="Sandbox vs Live" icon="flask">
How the two environments work, why your test changes never touch production, and when to flip to Live.
<Note>🎬 Coming soon</Note>
</Accordion>
<Accordion title="Your account: profile, environments & API keys" icon="key">
Set up your profile, understand environments, and create or revoke a Nevermined API key.
<Note>🎬 Coming soon</Note>
**Written guide:** [Get a Nevermined API key](/agents-guide/get-api-key)
</Accordion>
</AccordionGroup>

## For sellers

Monetize an AI agent and watch the money come in — from the **Selling** workspace.

<AccordionGroup>
<Accordion title="Seller first steps: the dashboard" icon="gauge">
A tour of the seller dashboard — agents, plans, revenue, API calls, and active users at a glance.
<Note>🎬 Coming soon</Note>
</Accordion>
<Accordion title="Connect Stripe" icon="stripe">
Link an existing Stripe account or create a new one so you can accept card payments.
<Note>🎬 Coming soon</Note>
</Accordion>
<Accordion title="Register your first AI agent" icon="robot">
Point Nevermined at any HTTP endpoint and register it as a payable agent.
<Note>🎬 Coming soon</Note>
**Written guide:** [Register agents](/products/nevermined-app/register-agents)
</Accordion>
<Accordion title="Create & manage payment plans" icon="tag">
Build plans across pricing models — fixed, usage-based, time-based, and credits.
<Note>🎬 Coming soon</Note>
**Written guide:** [Manage payment plans](/products/nevermined-app/manage-plans)
</Accordion>
<Accordion title="Track performance: events & analytics" icon="chart-line">
Read Request Events, Revenue Events, and Data Analytics to see what's earning.
<Note>🎬 Coming soon</Note>
**Written guide:** [Check your revenue](/agents-guide/check-revenue)
</Accordion>
</AccordionGroup>

## For buyers

Enroll a payment method and let trusted agents pay on your behalf — from the **Buying** workspace.

<AccordionGroup>
<Accordion title="Buyer first steps: dashboard & wallet" icon="wallet">
A tour of the buyer dashboard — your wallet (USDC / EURC), cards, delegations, and purchases.
<Note>🎬 Coming soon</Note>
</Accordion>
<Accordion title="Enroll a payment method" icon="credit-card">
Add a card so agents you trust can transact for you.
<Note>🎬 Coming soon</Note>
**Written guide:** [Enroll a card](/agents-guide/enroll-card)
</Accordion>
<Accordion title="Create a delegation" icon="user-shield">
Delegate a budget to a trusted agent, with limits, so it can pay without you in the loop.
<Note>🎬 Coming soon</Note>
**Written guide:** [Enroll a card & delegate a budget](/agents-guide/enroll-card)

@r-marques r-marques Aug 27, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

💡 NIT — "Create a delegation" re-links the enroll-card page when a dedicated delegation page exists

This link and the one under Enroll a payment method (:96) both point at /agents-guide/enroll-card, so two different accordions send the reader to the same page — and someone who clicked specifically for delegation lands on enrolment.

The repo has what looks like the intended target: solutions/card-delegation.mdx, which is nav-registered (docs.json:103), titled "Card Delegation", and described as "Let users enroll a credit or debit card once and delegate a spending budget to AI agents — directly in the app, via a white-labeled redirect, or embedded as a widget." It even carries icon: "user-shield", the same icon you gave this accordion.

Suggest [Card delegation](/solutions/card-delegation) here and leaving :96 as it is.

🤖 pr-review-toolkit · reviewer-verified · medium

</Accordion>
<Accordion title="Buy & consume a plan" icon="cart-shopping">
Purchase a plan, track credits, renew, and manage the agents connected to it.
<Note>🎬 Coming soon</Note>
**Written guide:** [Buy & call a paid agent](/getting-started/ai-agent-purchase)
</Accordion>
<Accordion title="See your payment requests" icon="receipt">
Follow the payments your agents make on your behalf.
<Note>🎬 Coming soon</Note>
</Accordion>
</AccordionGroup>

## The AI Services Catalog

<AccordionGroup>
<Accordion title="What the catalog is for" icon="store">
What the AI Services Catalog is, how buyers discover services, and how your agents get discovered.
<Note>🎬 Coming soon</Note>
**Written guide:** [Catalog overview](/products/catalog/overview)
</Accordion>
</AccordionGroup>

## For organizations

Run Nevermined for a team — plans, agents, widgets, members, and spend controls.

Check warning on line 126 in getting-started/video-tutorials.mdx

View check run for this annotation

Mintlify / Mintlify Validation (neverminedag) - vale-spellcheck

getting-started/video-tutorials.mdx#L126 

Did you really mean 'Nevermined'?

<AccordionGroup>
<Accordion title="Premium vs Enterprise" icon="building">
Create an organization and understand the main differences between the Premium and Enterprise tiers.
<Note>🎬 Coming soon</Note>
**Written guide:** [Organizations overview](/solutions/organizations/overview) · [Plans & billing](/solutions/organizations/plans-and-billing)
</Accordion>
<Accordion title="Org plans & org agents" icon="sitemap">
Publish plans and agents under your organization.
<Note>🎬 Coming soon</Note>
</Accordion>
<Accordion title="Set up your widgets" icon="window">
Embed Nevermined checkout, card enrollment, and delegation flows into your own site.
<Note>🎬 Coming soon</Note>
**Written guide:** [Embed Nevermined widgets](/integrations/organization-widgets)
</Accordion>
<Accordion title="People & spend control" icon="users-gear">
Add members and teams, manage customers, and set budgets and limits on how much users can spend.
<Note>🎬 Coming soon</Note>
**Written guide:** [Groups & budgets](/solutions/organizations/groups-and-budgets)
</Accordion>
<Accordion title="Advanced: org insights & agentic access" icon="chart-mixed">

Check warning on line 148 in getting-started/video-tutorials.mdx

View check run for this annotation

Mintlify / Mintlify Validation (neverminedag) - vale-spellcheck

getting-started/video-tutorials.mdx#L148 

Did you really mean 'agentic'?
Analytics, Events, and Realtime, plus programmatic and agentic access to your organization.

Check warning on line 149 in getting-started/video-tutorials.mdx

View check run for this annotation

Mintlify / Mintlify Validation (neverminedag) - vale-spellcheck

getting-started/video-tutorials.mdx#L149 

Did you really mean 'Realtime'?
<Note>🎬 Coming soon</Note>
**Written guide:** [Analytics](/solutions/organizations/analytics)
</Accordion>
</AccordionGroup>