Showcase the data-journey with a fun/easy-to-understand animation. - #471
Merged
Merged
Conversation
New 'The data journey' page under Understand with a self-running loop: three staggered document convoys travel from execution node to Generator client (signature seal stamps on), to the Host (signed copies from the other Generators stream in, vote dots light up, and the counter cycles 1 -> 2 -> 3), through the Lens transform (raw log flips to a TokenTransfer), and into the app under a pulsing verified shield. The loop is pure CSS keyframes so it runs without JS; the script adds a pause/play toggle, pauses the loop offscreen, and drives the counter. prefers-reduced-motion freezes a completed final frame, and the shortcode body doubles as a screen-reader description of the loop.
The branch had the ambient-loop variant committed; swap it for the chosen guided-player variant (page, shortcode, CSS, JS).
- Attestation record card widened from 176 to 200 units so all three vote_count dots fit inside it; secondary Generator labels move to the left of their circles so the wider card no longer overlaps them. - Signature squiggle is now centered in all three Generator nodes. - Lens transform station swaps its pause-button-like posts for a raw-document -> arrow -> structured-document symbol (schema in, schema out).
Deploying docs with
|
| Latest commit: |
2c2fec5
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://9eb4235f.docs-czv.pages.dev |
| Branch Preview URL: | https://test-explainer-animations.docs-czv.pages.dev |
The wave glyph read as a sine wave rather than 'working through data'. All three Generator nodes now show a gear (defined once in defs and reused via use) that spins while its station is the active step. The signature meaning stays on the packet's seal. Reduced-motion users get a static gear.
Run the page copy through the humanizer, Shinzo style guide, and markdown cleanup passes: - em dashes replaced with colons, periods, and commas (6 instances) - 'actually' dropped (2x); passive 'can be verified' made active - '-ing' tack-ons reworked in the description and View caption - takeaway bullets lose their bold lead-ins (the bold restated the bullet body) - caption 4 no longer says copies verify themselves; the Host does - 'travelling' -> 'traveling' in the SVG aria-label for spelling consistency with the rest of the docs Style-guide scan found no banned terms: no 'decentralized', no bare 'indexer'/'indexing', chain-agnostic wording throughout.
johnnymatthews
changed the title
The player was off on its own page and How it works just linked out to it. Now the animation sits right on the page, between the intro and the 'The data's journey' walkthrough, with the captions carried over unchanged. The standalone page is gone. Its old URL redirects to How it works through an alias, and the sidebar entry came out of config.toml. Also dropped the old page's intro and takeaway bullets, the prose already covers all of that. zola build, zola check, and check-links.sh all pass
Page was getting a bit long.
johnnymatthews
marked this pull request as ready for review
September 16, 2026 09:50
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a new "The data journey" page, and includes a fun little diagram/animation thingy to show readers each step of the flow.
Gonna keep playing around with the animation stuff for other diagrams throughout the docs.
Preview: https://test-explainer-animations.docs-czv.pages.dev/
Closes #368