livepeer · mintlify · Mar 18, 2026
diff --git a/contribute/CONTRIBUTING.mdx b/contribute/CONTRIBUTING.mdx
@@ -1,9 +1,7 @@
 ---
 title: Contributing to the Livepeer Docs
 sidebarTitle: Contribute
-description: >-
-  Canonical contributor workflow for docs content, components, tooling, quality
-  gates, and PR process.
+description: "Contributor workflow for Livepeer docs covering content, components, tooling, quality gates, and PR process."
 keywords:
   - livepeer
   - contribute

diff --git a/docs-guide/catalog/ai-tools.mdx b/docs-guide/catalog/ai-tools.mdx
@@ -1,3 +1,8 @@
+---
+title: "Ai Tools"
+description: "Governance entrypoint for the AI-tools registry, lane contracts, audit pipelines, and cross-agent pack outputs."
+---
+
 title: AI Tools Governance Index
 sidebarTitle: AI Tools
 description: 'Current governance entrypoint for the AI-tools registry, lane contract, audit-pipeline catalog, and generated pack outputs.'

diff --git a/docs-guide/catalog/templates-catalog.mdx b/docs-guide/catalog/templates-catalog.mdx
@@ -1,7 +1,7 @@
 ---
 title: 'Templates Catalog'
 sidebarTitle: 'Templates Catalog'
-description: 'Aggregate catalog of repository templates'
+description: "Auto-generated inventory of GitHub issue and PR templates with type, purpose, labels, and ownership details."
 keywords:
   [
     'livepeer',

diff --git a/docs-guide/catalog/workflows-catalog.mdx b/docs-guide/catalog/workflows-catalog.mdx
@@ -1,7 +1,7 @@
 ---
 title: 'Workflows Catalog'
 sidebarTitle: 'Workflows Catalog'
-description: 'Aggregate catalog of repository GitHub workflows'
+description: "Auto-generated inventory of GitHub Actions workflows with triggers, blocking policies, and output types."
 keywords:
   [
     'livepeer',

diff --git a/docs-guide/contributing/contributing.mdx b/docs-guide/contributing/contributing.mdx
@@ -1,7 +1,5 @@
 ---
-description: >-
-  This workflow is optional and maintainer-focused during the pilot period. It
-  is not a required contributor quality gate and is not part of CI.
+description: "Contributor guide with optional visual-explainer workflows for structural PR reviews and stakeholder verification."
 keywords:
   - livepeer
   - docs guide

diff --git a/docs-guide/contributing/mintlify.mdx b/docs-guide/contributing/mintlify.mdx
@@ -1,7 +1,7 @@
 ---
 title: 'Mintlify'
 sidebarTitle: Mintlify
-description: 'Description of mintlify'
+description: "Reference index of Mintlify built-in MDX components for layout, emphasis, API documentation, and page navigation."
 audience: developer
 pageType: landing
 purpose: landing

diff --git a/docs-guide/features/ai-features.mdx b/docs-guide/features/ai-features.mdx
@@ -1,7 +1,7 @@
 ---
 title: 'Ai-features'
 sidebarTitle: Ai-features
-description: 'Description of ai-features'
+description: "Overview of AI-powered features in the docs repo including Mintlify assistant, agent packs, skills, and AI pipelines."
 audience: developer
 pageType: landing
 purpose: landing

diff --git a/docs-guide/features/architecture-map.mdx b/docs-guide/features/architecture-map.mdx
@@ -1,9 +1,7 @@
 ---
 title: Architecture Map
 sidebarTitle: Architecture Map
-description: >-
-  Internal systems map for how content, tooling, validation, and automation
-  interact
+description: "Internal systems map showing how content authoring, local tooling, CI automation, and governance layers interact."
 keywords:
   - livepeer
   - architecture map

diff --git a/docs-guide/features/data-integrations.mdx b/docs-guide/features/data-integrations.mdx
@@ -1,9 +1,7 @@
 ---
 title: Data Integrations
 sidebarTitle: Data Integrations
-description: >-
-  This document maps primary API/data integrations used by docs content and
-  automations.
+description: "Maintainer reference mapping API specs, external data feeds, and internal data layers used by docs and automations."
 keywords:
   - livepeer
   - data integrations

diff --git a/docs-guide/frameworks/component-governance.mdx b/docs-guide/frameworks/component-governance.mdx
@@ -1,8 +1,6 @@
 ---
 title: Component Governance Framework
-description: >-
-  Canonical reference for how components are classified, built, documented, and
-  maintained in snippets/components/.
+description: "Canonical framework for classifying, building, documenting, and maintaining JSX components in snippets/components/."
 keywords:
   - livepeer
   - docs guide

diff --git a/docs-guide/frameworks/content-system.mdx b/docs-guide/frameworks/content-system.mdx
@@ -1,9 +1,7 @@
 ---
 title: Content System
 sidebarTitle: Content System
-description: >-
-  This document defines how product messaging, information architecture, and
-  technical depth are organized.
+description: "Defines how product messaging, information architecture, and technical depth are organized across docs layers."
 keywords:
   - livepeer
   - content system

diff --git a/docs-guide/frameworks/research-skill-workflow.mdx b/docs-guide/frameworks/research-skill-workflow.mdx
@@ -1,10 +1,7 @@
 ---
 title: Research Skill Workflow
 sidebarTitle: Research Skill
-description: >-
-  Canonical internal runbook for the experimental docs fact-check research
-  workflow, including sources of truth, operator commands, and maintenance
-  expectations.
+description: "Operator runbook for the experimental docs fact-check research workflow covering commands, trust tiers, and adjudication."
 keywords:
   - livepeer
   - docs guide

diff --git a/docs-guide/policies/audit-system-overview.mdx b/docs-guide/policies/audit-system-overview.mdx
@@ -1,9 +1,7 @@
 ---
 title: Audit System Overview
 sidebarTitle: Audit Overview
-description: >-
-  Static-first docs infrastructure audit system for quality, performance and
-  maintainability.
+description: "Overview of the static-first docs audit system for repository-wide quality, performance, and maintainability checks."
 keywords:
   - livepeer
   - docs audit

diff --git a/docs-guide/policies/cleanup-quarantine-policy.mdx b/docs-guide/policies/cleanup-quarantine-policy.mdx
@@ -1,9 +1,7 @@
 ---
 title: Cleanup Quarantine Policy
 sidebarTitle: Cleanup Policy
-description: >-
-  Conservative cleanup policy for docs infrastructure artefacts, scripts and
-  report outputs.
+description: "Conservative cleanup policy for docs infrastructure artifacts using classify-first, quarantine-second, delete-never defaults."
 keywords:
   - livepeer
   - cleanup

diff --git a/docs-guide/policies/infrastructure-principles.mdx b/docs-guide/policies/infrastructure-principles.mdx
@@ -1,9 +1,7 @@
 ---
 title: Infrastructure First Principles
 sidebarTitle: Infra Principles
-description: >-
-  Canonical first-principles design for repository infrastructure, quality
-  gates, automation flows, and policy layering.
+description: "Canonical first-principles architecture contract defining gate layers, severity model, and runtime budgets for repo infrastructure."
 keywords:
   - livepeer
   - infrastructure

diff --git a/docs-guide/policies/ownerless-governance.mdx b/docs-guide/policies/ownerless-governance.mdx
@@ -1,10 +1,7 @@
 ---
 title: Ownerless Governance
 sidebarTitle: Ownerless Governance
-description: >-
-  Canonical ownerless governance contract for repository surfaces that must
-  self-describe, self-validate, and provide exact repair paths for OSS
-  contributors and AI agents.
+description: "Governance contract ensuring repo surfaces self-describe, self-validate, and provide exact repair paths without a standing owner."
 audience: developer
 pageType: reference
 purpose: reference

diff --git a/docs-guide/policies/quality-gates.mdx b/docs-guide/policies/quality-gates.mdx
@@ -1,9 +1,7 @@
 ---
 title: Quality Gates Map
 sidebarTitle: Quality Gates
-description: >-
-  Layered quality gate map aligned to first-principles ownership and runtime
-  budgets.
+description: "Operational map of layered quality gates from pre-commit hooks through CI sweeps with ownership and blocking defaults."
 keywords:
   - livepeer
   - quality gates

diff --git a/docs-guide/tooling/content-brief-template.md b/docs-guide/tooling/content-brief-template.md
@@ -1,3 +1,8 @@
+---
+title: "Content Brief Template"
+description: "Structured content brief template with L0 value-proposition gates, persona mapping, and content sequence planning."
+---
+
 # Content Brief - [PAGE TITLE]
 
 **Tab:** [GPU Nodes / Gateways / Developers / Other]

diff --git a/docs-guide/tooling/dev-tools.mdx b/docs-guide/tooling/dev-tools.mdx
@@ -1,7 +1,7 @@
 ---
 title: Dev Tools
 sidebarTitle: Dev Tools
-description: This page provides developer tools and helpers for Livepeer docs contributors, including VS Code snippets for frontmatter, Mintlify components, and custom Livepeer components.
+description: "Developer tools for Livepeer docs contributors including VS Code snippets and component references."
 keywords:
   - livepeer
   - vscode snippets

diff --git a/v2/about/core-concepts.mdx b/v2/about/core-concepts.mdx
@@ -1,9 +1,7 @@
 ---
 title: Livepeer Core Concepts
 sidebarTitle: Livepeer Core Concepts
-description: >-
-  A high-level introduction to the key concepts and architecture of the Livepeer
-  Real-time AI & Video Network
+description: "Learn the core concepts of Livepeer: protocol, network, and actor roles that power decentralized video and AI."
 pageType: concept
 keywords:
   - livepeer

diff --git a/v2/about/livepeer-network/interfaces.mdx b/v2/about/livepeer-network/interfaces.mdx
@@ -1,9 +1,7 @@
 ---
 title: Network Interfaces
 sidebarTitle: Interfaces
-description: >-
-  How to interact with the Livepeer Network and protocol: REST and gRPC APIs,
-  GraphQL, JS SDK, CLI, and smart contract interfaces.
+description: "Explore Livepeer's developer interfaces: REST API, gRPC, GraphQL, JS SDK, CLI, and smart contracts."
 purpose: concept
 pageType: concept
 keywords:

diff --git a/v2/about/livepeer-network/job-lifecycle.mdx b/v2/about/livepeer-network/job-lifecycle.mdx
@@ -1,11 +1,7 @@
 ---
 title: Livepeer Job Lifecycle
 sidebarTitle: Job Lifecycle
-description: >-
-  This page describes the end-to-end “compute job” as a state machine. Since
-  Livepeer’s compute is segment-oriented, the lifecycle is modelled at the level
-  of a stream session and per-segment processing, with payment settlement
-  occurring continuously via tickets and periodically via reward calls.
+description: "Follow a Livepeer job from ingest to settlement, including segment dispatch, verification, and ticket payments."
 pageType: concept
 keywords:
   - livepeer

diff --git a/v2/about/livepeer-network/marketplace.mdx b/v2/about/livepeer-network/marketplace.mdx
@@ -1,9 +1,7 @@
 ---
 title: Livepeer Marketplace
 sidebarTitle: Marketplace
-description: >-
-  How the Livepeer Network marketplace matches demand and supply for real-time media compute: transcoding and AI
-  inference, including routing, pricing, and settlement.
+description: "Understand how Livepeer's marketplace matches compute demand with Orchestrator supply through routing and pricing."
 pageType: concept
 audience: general
 lastVerified: 2026-03-17

diff --git a/v2/about/livepeer-network/technical-architecture.mdx b/v2/about/livepeer-network/technical-architecture.mdx
@@ -1,9 +1,7 @@
 ---
 title: Network Technical Architecture
 sidebarTitle: Technical Architecture
-description: >-
-  Technical stack of the Livepeer Network: node types, gateway infrastructure, APIs, CLI, SDKs, and monitoring. How
-  orchestrators, gateways, and workers fit together.
+description: "Explore the Livepeer network stack: Orchestrator nodes, Gateway infrastructure, worker layers, APIs, and monitoring."
 pageType: concept
 audience: general
 lastVerified: 2026-03-17

diff --git a/v2/about/livepeer-overview.mdx b/v2/about/livepeer-overview.mdx
@@ -1,7 +1,7 @@
 ---
 title: Livepeer Overview
 sidebarTitle: Livepeer Overview
-description: An overview of the Livepeer protocol and network.
+description: "Get a high-level overview of Livepeer's decentralized protocol, network, actors, and marketplace for video and AI."
 pageType: overview
 audience: general
 lastVerified: 2026-03-17

diff --git a/v2/about/livepeer-protocol/core-mechanisms.mdx b/v2/about/livepeer-protocol/core-mechanisms.mdx
@@ -1,14 +1,7 @@
 ---
 title: Core Mechanisms and Functions
 sidebarTitle: Core Mechanisms
-description: >-
-  The Livepeer protocol secures a decentralised marketplace for verifiable media
-  and AI compute through a tightly coupled set of economic and cryptographic
-  systems. These mechanisms include LPT bonding, dynamic inflation, staking and
-  delegation, slashing conditions, and rewards distribution - all executed
-  through Ethereum-based smart contracts on Arbitrum. This page details each
-  core mechanism, how it interacts with others, and why these design decisions
-  underpin Livepeer’s scalable, permissionless infrastructure.
+description: "Learn how staking, delegation, inflation, slashing, and rewards secure the Livepeer protocol."
 pageType: concept
 keywords:
   - livepeer

diff --git a/v2/about/livepeer-protocol/economics.mdx b/v2/about/livepeer-protocol/economics.mdx
@@ -1,9 +1,7 @@
 ---
 title: Livepeer Protocol Economics
 sidebarTitle: Protocol Economics
-description: >-
-  Learn how LPT, staking, inflation, rewards, fees, and payment flows shape the
-  Livepeer protocol economy.
+description: "Understand Livepeer's economic flows: staking, inflation rewards, probabilistic payments, and fee distribution."
 pageType: concept
 keywords:
   - livepeer

diff --git a/v2/about/livepeer-protocol/governance-model.mdx b/v2/about/livepeer-protocol/governance-model.mdx
@@ -1,11 +1,7 @@
 ---
 title: Livepeer Governance Model
 sidebarTitle: Governance Model
-description: >-
-  This page describes the on-chain governance model which provides a
-  permissionless, transparent, and community-driven framework for upgrading and
-  governing the Livepeer protocol. It touches on the key actors, processes and
-  mechanisms that drive coordination and growth of the Livepeer ecosystem.
+description: "Learn how Livepeer governance works: LIP proposals, on-chain voting, quorum rules, and treasury spending."
 pageType: concept
 keywords:
   - livepeer

diff --git a/v2/about/livepeer-protocol/livepeer-token.mdx b/v2/about/livepeer-protocol/livepeer-token.mdx
@@ -1,12 +1,7 @@
 ---
 title: Livepeer Token
 sidebarTitle: Token (LPT) Utility
-description: >-
-  Livepeer Token (LPT) is the native proof-of-stake token of the Livepeer
-  network. It is the key to participating in the protocol: to operate or
-  delegate in the transcoding network, to earn rewards, and to vote on
-  governance proposals. This page details the technical attributes, token supply
-  dynamics, inflation model, and contract integrations that define LPT’s role.
+description: "Learn about the Livepeer Token (LPT): its role in staking, governance, inflation, and protocol security."
 pageType: concept
 keywords:
   - livepeer

diff --git a/v2/about/livepeer-protocol/overview.mdx b/v2/about/livepeer-protocol/overview.mdx
@@ -1,11 +1,7 @@
 ---
 title: Protocol Overview
 sidebarTitle: Overview
-description: >-
-  This section outlines the design, contract architecture, staking & reward
-  mechanisms, incentive alignment and governance model of the on-chain Livepeer
-  Protocol that governs how work is coordinated, secured and rewarded and how
-  upgrades are proposed and implemented.
+description: "Overview of the Livepeer protocol: on-chain coordination, staking, rewards, governance, and contract architecture."
 keywords:
   - livepeer
   - about

diff --git a/v2/about/livepeer-protocol/technical-architecture.mdx b/v2/about/livepeer-protocol/technical-architecture.mdx
@@ -1,7 +1,7 @@
 ---
 title: Technical Overview
 sidebarTitle: Technical Architecture
-description: A technical overview of the Livepeer protocol.
+description: "Explore the Livepeer protocol's smart contract architecture, system layers, and on-chain component diagrams."
 pageType: concept
 keywords:
   - livepeer

diff --git a/v2/about/livepeer-protocol/treasury.mdx b/v2/about/livepeer-protocol/treasury.mdx
@@ -1,9 +1,7 @@
 ---
 title: Livepeer Treasury
 sidebarTitle: Treasury
-description: >-
-  This page outlines how the treasury accumulates funds, how disbursements are
-  authorised, and how its role is evolving across the protocol’s roadmap.
+description: "Learn how the Livepeer treasury accumulates funds from inflation and funds ecosystem public goods via governance."
 pageType: concept
 keywords:
   - livepeer

diff --git a/v2/about/mental-model.mdx b/v2/about/mental-model.mdx
@@ -1,10 +1,7 @@
 ---
 title: The Livepeer Stack and Mental Model
 sidebarTitle: Livepeer Mental Model
-description: >-
-  A high-level introduction to the key concepts workings of the Livepeer open,
-  on-demand AI & Media infrastructure substrate and the distributed
-  crypto-primitive coordination system.
+description: "Understand Livepeer as a layered stack: protocol, network, and platform mapped to an OSI-like mental model."
 pageType: concept
 keywords:
   - livepeer

diff --git a/v2/about/resources/livepeer-glossary.mdx b/v2/about/resources/livepeer-glossary.mdx
@@ -1,9 +1,7 @@
 ---
 title: Livepeer Glossary
 sidebarTitle: Livepeer Glossary
-description: >-
-  A comprehensive glossary of terms used in the Livepeer Real-time AI & Video
-  Network
+description: "Look up key Livepeer terms covering protocol actors, web3 concepts, video engineering, and AI terminology."
 keywords:
   - livepeer
   - resources

diff --git a/v2/about/resources/livepeer-whitepaper.mdx b/v2/about/resources/livepeer-whitepaper.mdx
@@ -1,9 +1,7 @@
 ---
 title: Livepeer Whitepaper
 sidebarTitle: Whitepaper
-description: >-
-  Read the original Livepeer whitepaper and understand how its decentralised
-  video vision evolved into the current network.
+description: "Read the original Livepeer whitepaper and see how the decentralized video vision evolved into today's network."
 purpose: reference
 pageType: reference
 keywords:

diff --git a/v2/cn/about/core-concepts.mdx b/v2/cn/about/core-concepts.mdx
@@ -1,7 +1,7 @@
 ---
 title: Livepeer 核心概念
 sidebarTitle: Livepeer 核心概念
-description: 对 Livepeer 实时 AI 与视频网络的关键概念和架构的高级介绍
+description: "了解 Livepeer 的核心概念，包括协议与网络的分离、链上与链下架构及关键参与者角色"
 keywords:
   - livepeer
   - about

diff --git a/v2/cn/about/livepeer-network/actors.mdx b/v2/cn/about/livepeer-network/actors.mdx
@@ -1,7 +1,7 @@
 ---
 title: 演员概览
 sidebarTitle: 演员概览
-description: 谁参与 Livepeer，每个角色的职责是什么，以及角色如何相互作用。
+description: "了解 Livepeer 网络中的核心参与者：编排者、委托者和网关的职责与交互方式"
 keywords:
   - livepeer
   - about