Skip to content

docs(readme): embed an animated demo preview and cut redundancy#365

Merged
plind-junior merged 1 commit into
testfrom
docs/readme-video-and-cleanup
Jul 6, 2026
Merged

docs(readme): embed an animated demo preview and cut redundancy#365
plind-junior merged 1 commit into
testfrom
docs/readme-video-and-cleanup

Conversation

@plind-junior

Copy link
Copy Markdown
Collaborator

github renders no inline player for repo-committed mp4s, so the how-it-works poster becomes a 3x-speed animated gif preview (6.4mb, 720px, 10fps) that plays right in the readme and clicks through to the full video with audio. the unused poster jpg is removed; the committed mp4 stays as-is (already 720p/3.4mb, faststart).

trims 145 lines of duplication: the running-the-tests section (contributing.md territory), the long gittensor walkthrough (the top callout + docs/gittensor.md cover it), the full cli dump (vouch --help / vouch capabilities), the trust-metadata deep-dive (spec.md), and the what-ships-today table. also drops the stale "per-runtime adapter templates not yet shipped" line — adapters/ ships them.

What changed

Why

What might break

VEP

Tests

  • make check passes locally (lint + mypy + pytest)
  • New / changed behaviour has a test
  • CHANGELOG.md updated under ## [Unreleased]

Copilot AI review requested due to automatic review settings July 6, 2026 01:16
@coderabbitai

coderabbitai Bot commented Jul 6, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: f5ebca26-59ab-41f7-8278-d8bcdf255765

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/readme-video-and-cleanup

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions github-actions Bot added docs documentation, specs, examples, and repo guidance size: XS less than 50 changed non-doc lines labels Jul 6, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Updates the project README to improve the “watch it work” experience on GitHub (inline animated preview that links to the full MP4) while removing several large, redundant sections in favor of pointing readers to the canonical docs.

Changes:

  • Replaces the static demo poster image link with an animated GIF preview that links through to the full MP4.
  • Trims substantial duplicated content (tests, Gittensor walkthrough, full CLI dump, trust-metadata deep dive, “what ships today” table) to reduce README length and staleness risk.
  • Tightens/reshapes several sections (install blurb, automatic session capture explanation, CLI surface summary, trust-metadata reference).

Comment thread README.md
Comment on lines +190 to +197
vouch status | pending | review | show <id> # inspect the queue
vouch approve <id> [--reason ...] # the gate
vouch reject <id> --reason "..."

vouch propose-claim|propose-page|... # human mirror of the kb.propose_* tools
vouch search QUERY | context TASK | recall # retrieval
vouch compile [--dry-run] # llm-wiki ingest: draft topic pages from claims
vouch export | import-check | import-apply # portable bundles
github renders no inline player for repo-committed mp4s, so the
how-it-works poster becomes a 3x-speed animated gif preview (6.4mb,
720px, 10fps) that plays right in the readme and clicks through to
the full video with audio. the unused poster jpg is removed; the
committed mp4 stays as-is (already 720p/3.4mb, faststart).

trims 145 lines of duplication: the running-the-tests section
(contributing.md territory), the long gittensor walkthrough (the top
callout + docs/gittensor.md cover it), the full cli dump (vouch
--help / vouch capabilities), the trust-metadata deep-dive (spec.md),
and the what-ships-today table. also drops the stale "per-runtime
adapter templates not yet shipped" line — adapters/ ships them.
@plind-junior plind-junior force-pushed the docs/readme-video-and-cleanup branch from 7c06862 to a2bc8cd Compare July 6, 2026 01:21
@plind-junior plind-junior merged commit 6b761a1 into test Jul 6, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs documentation, specs, examples, and repo guidance size: XS less than 50 changed non-doc lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants