Updated shipping notes in README

no ref

The monorepo by default will ship all packages out of convenience. Sometimes this is a bit heavy-handed, so there's notes added on how to limit `nx` to a reduced scope.

Author: 9larsons

README.md

@@ -2,52 +2,49 @@
 
 ## Install
 
-
 ## Usage
 
-
 ## Develop
 
 This is a mono repository, managed with [Nx](https://nx.dev).
 
 1. `git clone` this repo & `cd` into it as usual
 2. run `pnpm setup` from the top-level:
-   - installs all external dependencies
-   - links all internal dependencies
+    - installs all external dependencies
+    - links all internal dependencies
 
 To add a new package to the repo:
-   - install [slimer](https://github.com/TryGhost/slimer)
-   - run `slimer new <package name>`
 
+- install [slimer](https://github.com/TryGhost/slimer)
+- run `slimer new <package name>`
 
 ## Run
 
 - `pnpm dev`
 
-
 ## Test
 
 - `pnpm lint` runs `oxlint` across all packages
 - `pnpm format` formats `js/ts/json/md` files with `oxfmt`
 - `pnpm format:check` checks formatting without writing
 - `pnpm test` runs tests (most packages also run lint in `posttest`)
 
-
 ## Publish
 
 1. run one of the release commands in the top-level `framework` directory:
-   - `pnpm ship:patch`
-   - `pnpm ship:minor`
-   - `pnpm ship:major`
-   - for initial Nx bootstrap in long-unreleased repos: `pnpm ship:first-release`
+    - `pnpm ship:patch`
+    - `pnpm ship:minor`
+    - `pnpm ship:major`
+    - for initial Nx bootstrap in long-unreleased repos: `pnpm ship:first-release`
+    - by default these bump **every** package in `packages/*` to the same level. To scope a release to specific packages, append `--projects=` with comma-separated directory names (not npm names), e.g. `pnpm ship:minor --projects=api-framework,domain-events`
+    - append `--dry-run` to preview which packages would be bumped without committing
 2. this runs tests, versions packages, and creates/pushes release commit + tags
-   - creates the version commit and pushes tags to `main`
+    - creates the version commit and pushes tags to `main`
 3. CI automatically publishes packages via `.github/workflows/publish.yml`:
-   - authenticates to npm via [Trusted Publishing](https://docs.npmjs.com/trusted-publishers) (OIDC, no long-lived tokens)
-   - checks each `packages/*` package version against npm
-   - runs `pnpm publish` (via `nx release publish`) only for versions that are not already published, with provenance attestations enabled
-
+    - authenticates to npm via [Trusted Publishing](https://docs.npmjs.com/trusted-publishers) (OIDC, no long-lived tokens)
+    - checks each `packages/*` package version against npm
+    - runs `pnpm publish` (via `nx release publish`) only for versions that are not already published, with provenance attestations enabled
 
-# Copyright & License 
+# Copyright & License
 
 Copyright (c) 2013-2026 Ghost Foundation - Released under the [MIT license](LICENSE).