Skip to content

docs: update the reference topology diagram to the latest export - #1200

Merged
evantahler merged 1 commit into
mainfrom
docs/update-topology-diagram-export
Sep 17, 2026
Merged

evantahler merged 1 commit into
mainfrom
docs/update-topology-diagram-export

Conversation

@evantahler

@evantahler evantahler commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #1194, which merged with the previous export. This swaps in the newer diagram.

What changed

The new export adds the diagram title and a key marking the tool calling hot path and the arcade deploy path, and draws a clearer split between the application plane and worker plane clusters.

old new
format PNG JPEG
dimensions 9772 × 5362 7800 × 4280
size 1.95 MB 1.93 MB

On the file extension

The export arrived named .png but is actually JPEG data (file reports JPEG image data, JFIF standard 1.01), so it lands here as .jpg rather than carrying an extension that lies about its format.

Re-encoding to a real PNG was the alternative, but it doubles the file to 3.8 MB and recovers no detail — the JPEG artifacts are already baked into what Whimsical exported. A genuinely lossless PNG would need a fresh export from the source diagram, not a conversion of this one.

Layout

Aspect ratio is identical (1.8224), so nothing shifts. Verified in a browser at a 1440px viewport — the figure measures 832px, exactly matching the body paragraph and the services table, and the dark-mode dimming from #1194 still meets the panel seamlessly.

width/height are updated to the new intrinsics so there is no layout shift, and the alt text picks up the plane split and the key.

~ 🎹 Evanescence, Evan's Agent


Note

Low Risk
Documentation-only image and alt-text update with no runtime or security impact.

Overview
Replaces the platform architecture reference topology figure with a newer Whimsical export on the deploy architecture page.

The linked asset moves from PNG to .jpg (matching the actual JPEG export) and width/height are set to 7800×4280 so layout stays stable. Alt text is expanded to match the updated diagram: separate application plane and worker plane clusters, additional in-cluster services (Usage, embedding/search, OpenFGA, custom MCP servers), egress to container registries, and a key for the tool-calling hot path and arcade deploy path.

Reviewed by Cursor Bugbot for commit 79fd379. Bugbot is set up for automated code reviews on this repo. Configure here.

Swaps in the new export, which adds the diagram title and a key marking
the tool calling hot path and the arcade deploy path.

The file is JPEG data despite the .png name it arrived with, so it lands
as .jpg rather than lying about its format. Re-encoding it to real PNG
was the other option, but that doubles the file to 3.8MB and recovers no
detail, since the JPEG artifacts are already baked in.

Intrinsic dimensions go to 7800x4280. Same aspect ratio as before, so
the layout is unchanged. The alt text picks up the application and
worker plane split and the key.

~ 🎹 Evanescence, Evan's Agent
@vercel

vercel Bot commented Sep 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Sep 17, 2026 4:23pm UTC

Request Review

@evantahler
evantahler merged commit 5924522 into main Sep 17, 2026
10 checks passed
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