Skip to content

docs: restore the asciinema demo link and embed - #386

Merged
wagmiiii merged 1 commit into
mainfrom
docs/restore-demo-link
Aug 11, 2026
Merged

docs: restore the asciinema demo link and embed#386
wagmiiii merged 1 commit into
mainfrom
docs/restore-demo-link

Conversation

@mallison031

Copy link
Copy Markdown
Collaborator

Description

The asciinema recording at https://asciinema.org/a/qqC0RysuCDBvfUXC is reachable again, so this restores every reference that was dropped when it was believed to have expired:

  • README.md — the Demo link in the header nav and the asciicast embed at the top of Overview
  • site/index.html — the full <section id="demo"> "See It in Action" block, restored verbatim from before its removal
  • site/README.md and CHANGELOG.md — "asciinema demo embed" back in the landing-site description
  • audit_and_roadmap.md — the Phase 12 "Demo Video" and Step 4 "Record a short demo video" entries

Two notes for the reviewer:

  1. Duplicate roadmap bullets collapsed. Both demo entries in audit_and_roadmap.md appeared twice, with differently-worded removal notes ("temporarily removed while the asciinema recording is refreshed" vs. "removed as the link is no longer accessible"). That looks like a merge artifact. Each pair is collapsed back to a single restored bullet.
  2. Line references updated. The roadmap cited README.md:9; the Dashboard link added since then shifted the demo down to README.md:10.

Related Issue

Reverts the documentation half of #224, which removed these references on the grounds that the link was dead.

Motivation and Context

#224 removed the demo link because it 404'd at the time. The recording resolves again now, and the landing page has been carrying a placeholder HTML comment where its demo section used to be. The .demo-box, .demo-player-wrapper, and .demo-fallback rules were never deleted from site/styles.css, so the restored markup is styled with no CSS changes needed.

How Has This Been Tested?

Docs and static-site only — no Rust code touched.

Link liveness verified before restoring rather than assumed:

  • https://asciinema.org/a/qqC0RysuCDBvfUXC200, titled "Soroban Budget Assert — CI budget assertions & network-verified cost report demo"

  • https://asciinema.org/a/qqC0RysuCDBvfUXC.svg200, image/svg+xml (the README badge)

  • https://asciinema.org/a/qqC0RysuCDBvfUXC/iframe200 (the landing-page embed)

  • Added/Updated tests

  • Passed cargo test

  • Passed cargo clippy

  • Formatted with cargo fmt

  • Reviewed or re-measured budget limits in amm-pool-contract/tests/budget_test.rs when contract, build profile, or toolchain changes may affect them

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

The recording at asciinema.org/a/qqC0RysuCDBvfUXC is reachable again
(verified 200 on the page, the .svg badge, and the /iframe endpoint), so
restore every reference that was dropped when it was thought expired:

- README.md: the Demo header link and the asciicast embed in Overview
- site/index.html: the full "See It in Action" demo section
- site/README.md and CHANGELOG.md: the demo embed in the site description
- audit_and_roadmap.md: the Phase 12 and Step 4 demo entries, collapsing
  the duplicate bullets a merge had left behind
@wagmiiii
wagmiiii merged commit 313a64e into main Aug 11, 2026
9 checks passed
@mallison031
mallison031 deleted the docs/restore-demo-link branch August 11, 2026 14:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants