Skip to content

Use authored explainer pilots in cache and link challenges #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
triggeredcode wants to merge 2 commits into
base: feat/contributor-loop-challenge-quality
Choose a base branch
from
Open

Use authored explainer pilots in cache and link challenges #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0312b9a
content: distinguish cache tiers with eviction stories
triggeredcode Oct 16, 2026
f89f765
content: illustrate lost acknowledgements and safe retries
triggeredcode Oct 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 3 additions & 9 deletions challenges/cache-pressure-easy/statement.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,10 @@
{
"kind": "figure",
"label": "FIG 1",
"presentation": "immersive",
"illustration": {
"id": "systems.snapshot",
"props": {
"title": "Oldest on the left · newest on the right",
"rows": [
{ "label": "After two puts", "cells": [{ "label": "A", "detail": "oldest", "tone": "warning" }, { "label": "B", "detail": "newest", "tone": "accent" }] },
{ "label": "Get A", "cells": [{ "label": "B", "detail": "oldest", "tone": "warning" }, { "label": "A", "detail": "newest", "tone": "signal" }], "note": "A hit changes order without fetching from the backing store." },
{ "label": "Put C", "cells": [{ "label": "A", "detail": "oldest", "tone": "accent" }, { "label": "C", "detail": "newest", "tone": "signal" }], "note": "B leaves because it was least recently used." }
]
}
"id": "systems.cache-story",
"props": { "mode": "lru" }
},
"caption": "One hit changes the eviction decision. This two-entry example illustrates order; real capacity counts each value's bytes plus metadata."
},
Expand Down
12 changes: 3 additions & 9 deletions challenges/cache-pressure-medium/statement.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,10 @@
{
"kind": "figure",
"label": "FIG 1",
"presentation": "immersive",
"illustration": {
"id": "systems.snapshot",
"props": {
"title": "What a one-time scan does to a small cache",
"rows": [
{ "label": "Warm", "cells": [{ "label": "H1", "tone": "signal" }, { "label": "H2", "tone": "signal" }, { "label": "H3", "tone": "signal" }], "note": "The hot set is reused often." },
{ "label": "Cold scan", "cells": [{ "label": "S1", "tone": "warning" }, { "label": "S2", "tone": "warning" }, { "label": "S3", "tone": "warning" }], "note": "Pure LRU fills the budget with one-hit keys." },
{ "label": "Return", "cells": [{ "label": "H1 miss", "tone": "danger" }, { "label": "H2 miss", "tone": "danger" }, { "label": "H3 miss", "tone": "danger" }], "note": "A protected hot segment would keep these requests cheap." }
]
}
"id": "systems.cache-story",
"props": { "mode": "scan" }
},
"caption": "Pure LRU mistakes recent for reusable. A one-time scan looks important long enough to evict the data that will actually return."
},
Expand Down
16 changes: 3 additions & 13 deletions challenges/lossy-link-easy/statement.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,20 +8,10 @@
{
"kind": "figure",
"label": "FIG 1",
"presentation": "immersive",
"illustration": {
"id": "systems.exchange",
"props": {
"title": "A lost ACK is why duplicates must be safe",
"left": "Sender",
"right": "Receiver",
"events": [
{ "from": "left", "label": "DATA 0 · abc", "detail": "deliver abc", "tone": "signal" },
{ "from": "right", "label": "ACK 0", "detail": "waiting", "dropped": true, "tone": "danger" },
{ "from": "local", "label": "timer fires", "tone": "warning" },
{ "from": "left", "label": "DATA 0 · retry", "detail": "duplicate, no delivery", "tone": "warning" },
{ "from": "right", "label": "ACK 0 again", "detail": "advance to 1", "tone": "accent" }
]
}
"id": "systems.lost-ack-story",
"props": {}
},
"caption": "Loss or corruption leaves the sender waiting. When its timer fires, it retransmits the same packet; the receiver discards duplicates but repeats the ACK."
},
Expand Down
Loading