Add ERCs repo-local setup wrappers and contributor documentation for the V2 multi-repo local build workflow.
The setup scripts treat this checkout as <workspace>/ERCs, reuse or install a released build-eips binary with checksum verification, install or reuse Zola 0.22.1 with pinned archive hashes, run build-eips init --template --platform-dev, and surface doctor failures as warnings after bootstrap.
Update CI to use editorial check --against-upstream --format github, update publish to use plain build now that eipw linting is no longer part of build/check/serve, add contributor setup guidance, expand the README local workflow docs, and move homepage badges into structured front matter.
This builds on the tracked Build.toml manifest added separately for ERCs repo identity, related proposal repos, canonical base URLs, and theme pin.
Summary
This PR is the ERCs repo rollout for the V2 local build workspace. It wires ERCs into the contributor workflow without changing proposal content: contributors can run a repo-local setup script, get the expected surrounding workspace, and use the updated
build-eipscommand surface for checking, building, serving, previewing, and publishing ERCs.scripts/dev-setupentrypoints for ERCs contributors.build-eipsand Zola.build-eipsrelease archives are verified against fetched.sha256sidecars; Zola archives are verified against per-platform hashes pinned in the scripts.<workspace>/ERCs/.build-eips initwith--template --platform-devso the contributor workspace includes proposal siblings, theme, template, preprocessor, and eipw checkouts.build-eips doctorafter init and surface doctor failures as warnings rather than hard setup failures.check --format githubtoeditorial check --against-upstream --format github.build --no-lintand its accompanying justification comment to plainbuild..github/CONTRIBUTING.mdpointer to./scripts/dev-setupand the generatedWORKSPACE.mdcommand/configuration reference.README.mdwith local workflow documentation for setup, check/build/serve/preview, local settings, targeted rendering, editorial validation, and workspace reference handoff.Closes eips-wg/theme/issues/5
Closes eips-wg/preprocessor/issues/14
Review Notes
This is the ERCs repo rollout for the V2 multi-repo local build system. It wires this repository into the workspace model introduced by the preprocessor stack; it does not change proposal content.
The setup scripts are repo-local convenience wrappers for ERCs contributors. They install a released
build-eipsbinary when needed, or reuse an existingbuild-eipsonPATHor in the default user-local install path. They do not buildbuild-eipsfrom this repo.Unlike the theme setup script in V2:19, the ERCs setup script treats this repo as the active proposal root, hard-codes
--template --platform-dev, and does not accept CLI flags or anACTIVE_REPO_ROOToverride. ERCs contributors always get the full contributor workspace.Zola follows the same reuse-first shape: the scripts use Zola from
PATHor the default user-local install path when available. They install Zola 0.22.1 if the discovered version is missing, older than 0.22.1, or unparseable; they reuse 0.22.1 and warn-but-continue for newer versions.build-eipsrelease downloads are verified against fetched.sha256sidecars. That depends on the release-side checksum generation added in V2:17. Zola downloads are verified against per-platform hashes pinned in these scripts.The setup scripts always pass
--template --platform-devtobuild-eips init. The behavior of those init flags lives in the preprocessor setup path;--platform-devwas added in V2:17.The CI command moves to
editorial check --against-upstream --format github, which is the targeted editorial validation surface introduced in V2:14.Publish previously passed
--no-lintto skip eipw linting on the master checkout. After V2:15 moved eipw out of build/check/serve entirely, that flag is no longer needed and publish can use plainbuild.Much of the README diff rewrites existing prose into a new local-workflow structure and unwraps paragraphs; those parts are documentation reshaping, not proposal-content or command-behavior changes.
The README intentionally documents the final preprocessor command surface for ERCs contributors, then points to generated
../WORKSPACE.mdfor the full command reference from V2:18.