Development

How this repository is built and changed. What every repository shares is in the standard, and isn't repeated here.

Changing the standard

A change to how things are done starts here: in the config, in the standard and, when it can be checked, in scripts/survey.ts. pnpm drift then lists the repositories to bring in line, each with its own pull request. What the change taught goes in the lessons, in the same pull request.

The scripts

The scripts keep the repositories in step, and run with Node, so there's no build. scripts/ says what each one does.

The site

The home page is index.html, with the survey's tables written in at build time, and 404.html. The build also renders docs/ with markz, so the standard reads at ship.amitkaps.com/docs/standard.md, and a bar on every page links the docs in their nav order (scripts/docs.ts). pnpm dev renders a doc on each request, so it reads as it's written. All the pages share style.css.

The Worker ship is connected to this repository, and each push to main builds and deploys it. Its dashboard settings are the ones every Worker has, listed in the standard.

Beta packages

Two packages are still beta. Check them with pnpm view <name> dist-tags.

When a package graduates, update the pins in package.json and the table above. Then run pnpm run verify and a deploy from the Git-connected Worker before you rely on it.