Set Up the Repository
This source setup does not install Beskid for an end user. Use the installation procedure for a supported release.
Prerequisites
Section titled “Prerequisites”Create a repository checkout. Install Git and the pinned pnpm toolchain. Confirm which root or submodule owner accepts the change.
Actions
Section titled “Actions”- From the superrepo root, run
./scripts/setup-environment.shto initialize pinned submodules and install root packages. - Inspect
git status --shortin the root. - Inspect
git status --shortin the submodule that you will change. - Run
pnpm --dir site/website testfor website guidance changes. - Run the focused gate that the changed component documents.
- Run broader gates only when the change crosses a contract boundary.
- Edit public guidance in
site/website/src/content/docs/. - Use the owning generator for derived files; do not edit generated output.
Expected result
Section titled “Expected result”The checkout contains the pinned submodule commits unless an owner made an intentional change. The focused gate passes and reports the changed component.
Recovery
Section titled “Recovery”If a submodule has unrelated work, preserve it and contact the submodule owner. Do not reset unrelated dirty state. If package installation fails, verify pnpm and the root lockfile before you change dependencies.