docs: lead Quick start with forkd pull, plus v0.3.4 / doctor-screenshot polish#165
Merged
Conversation
Stale-content sweep after v0.3.4 ship + 4 v0.4 PoCs landed: - ROADMAP.md: bump 'Current release' from v0.3.1 to v0.3.4; add v0.4 RFC pointer; fix 'v0.2.x retro' → 'v0.4 retro' in speculative section. - README.md: '3 PoCs' → '4 PoCs' (Phase 4 restore PoC landed); extend phase-1 ship range to v0.3.0 → v0.3.4 with the multi-BRANCH fix note. - README-zh.md: mirror the EN updates — port the missing 'filesystem state, not just reasoning' section, refresh the v0.3.0 → v0.3.4 ship line, sync the recipes list to include jupyter-kernel / playwright-browser / postgres-fixture. - INTEGRATION-BOXLITE.md: extend ship range to v0.3.4, replace stale '14× aggregate' callout with the v0.3.4 17.6×/8.5× multi-BRANCH numbers + posix_fallocate fix narrative. - RESULTS-v0.3.md: embed v0.3.4-before-after.png chart alongside the 10-BRANCH numbers table. - Remove orphan docs/assets/wp-bench-demo.tape (vhs pivot to asciinema, .tape no longer used). Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
Previously this lived on imgur and was only referenced from outside the repo (HN post, etc.). Pulling it in-repo so: - README has a concrete visual for what 'forkd doctor passes' means - the screenshot survives independently of any third-party host - WebP keeps the asset small (82 KB vs 178 KB JPEG) Captured on the dev box: Linux 6.14, FC v1.12.0, 134 snapshots, 636 GiB free in the snapshot dir, daemon reachable on 127.0.0.1:8889. Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
Promote the Hub pull flow from "Fastest path — alternative section" to the recommended first-fork experience in both README.md and README-zh.md. The other quickstart sections (from-image, from-source) are reframed as alternatives for users who need custom recipes. The Chinese README previously omitted the Hub flow entirely; this PR adds the parallel `forkd pull deeplethe/langgraph-react` section and renumbers the trailing sections accordingly. End-to-end verified on the dev box: `forkd pull deeplethe/langgraph-react` downloads the 14.5 MiB pack in ~15 s, sha256 verifies, unpacks at tag `langgraph` ready for `forkd fork --tag langgraph -n 3`. Closes the M1.2 ROADMAP item "README quickstart rewritten to lead with `forkd pull`".
WaylandYang
added a commit
that referenced
this pull request
May 27, 2026
…h pull (#173) ROADMAP M1.2 done-when items all flipped to ✓: - Hosting decided as GitHub Releases (not R2/S3 — free, free egress, stable URLs, no infra to operate). Dropped the forkd-hub.deeplethe.com custom-domain plan as unnecessary. - 9 snapshot-producing recipes published: python-numpy, playwright-browser, postgres-fixture, coding-agent, nodejs, e2b-codeinterpreter, jupyter-kernel, langgraph-react, coding-agent-fork. agent-workbench remains for follow-up (its ghcr.io base image pull is rate-limit-sensitive). - README quickstart already leads with `forkd pull` (shipped #165 this week, both en/zh). docs/HUB.md "What's currently published" table expanded from 2 to 9 entries, the "more recipes will land" disclaimer removed.
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.
Summary
Closes the open M1.2 ROADMAP item "README quickstart rewritten to lead with
forkd pull" and folds in two hygiene-grade docs commits that had been sitting ondev.What changed
Three commits, all docs:
f13de9cdocs: audit sweep — sync stale v0.3.1/v0.3.2 refs to v0.3.4— sweeps version strings across docs to match the current release.a4afa41docs: embed forkd doctor screenshot (14 checks pass) into repo— inlines the doctor screenshot into the install section.6cf8ab4docs: lead Quick start with forkd pull recipe path— the M1.2 wrap:forkd pull deeplethe/langgraph-reactsnippet and renumbers the trailing sections.End-to-end verification
Same recipe, English README quickstart, copy-paste from a clean shell on the dev box.
Out of scope
deeplethe/langgraph-reactanddeeplethe/coding-agent-fork; that's enough to make theforkd pullquickstart path real.