ci: publish next only when its code or docs change (#92)

Main previews runs only for pushes that change src/, Cargo.toml,
Cargo.lock or the preview pipeline; the Docs workflow's push to next/ uses
the same paths as its PR previews.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

Author: alukach

.github/workflows/docs.yml

@@ -12,6 +12,7 @@ on:
     types: [published]
   push:
     branches: [main]
+    paths: ["README.md", "docs/**", "!docs/recorder/**", ".github/workflows/docs*.yml"]
   pull_request:
     types: [opened, reopened, synchronize, closed]
     paths: ["README.md", "docs/**", "!docs/recorder/**", ".github/workflows/docs*.yml"]

.github/workflows/main-previews.yml

@@ -1,11 +1,20 @@
 name: Main previews
 
-# After each push to main, publishes it as the `next` preview (see Preview
-# build): source-coop-next with production's defaults, the next release, and
-# source-coop-next-staging calling source.coop's staging environment.
+# After each push to main that changes what's built, publishes it as the
+# `next` preview (see Preview build): source-coop-next with production's
+# defaults, the next release, and source-coop-next-staging calling
+# source.coop's staging environment. A push that changes only docs or CI
+# elsewhere leaves the last one in place.
 on:
   push:
     branches: [main]
+    paths:
+      - "src/**"
+      - "Cargo.toml"
+      - "Cargo.lock"
+      - ".github/preview/install.sh"
+      - ".github/workflows/main-previews.yml"
+      - ".github/workflows/preview-build.yml"
 
 permissions:
   contents: write

CONTRIBUTING.md

@@ -27,7 +27,7 @@ curl -LsSf https://github.com/source-cooperative/source-coop-cli/releases/downlo
 
 Running it again updates the preview. For a `both` preview, that line installs the production build; add `-s -- staging` after `sh` for the staging one.
 
-**Every push to main is published as the `next` preview** (the *Main previews* workflow): `source-coop-next` is the next release as it stands, and `source-coop-next-staging` is the same commit calling staging. Its docs go to <https://source-cooperative.github.io/source-coop-cli/next/>, listed as `next` in the version menu; `latest/` stays the newest release.
+**Every push to main that changes the code (`src/`, `Cargo.toml`, `Cargo.lock`) is published as the `next` preview** (the *Main previews* workflow): `source-coop-next` is the next release as it stands, and `source-coop-next-staging` is the same commit calling staging. Its docs go to <https://source-cooperative.github.io/source-coop-cli/next/> when the README or `docs/` changes, listed as `next` in the version menu; `latest/` stays the newest release.
 
 ```bash
 curl -LsSf https://github.com/source-cooperative/source-coop-cli/releases/download/next/install.sh | sh                  # source-coop-next