← Commit history

Upload 1 file(s)

John Lauer ·6623694a3a ·2mo ago ·parent 0d5f0c8
1 file changed +3−3
CONTRIBUTING.md+3−3
@@ -12,13 +12,13 @@ This bridge is part of the [Adom Desktop](https://github.com/adom-inc/adom-deskt 1. **Develop locally.** Clone this repo, edit, test. The bridge runs alongside an installed [Adom Desktop](https://github.com/adom-inc/adom-desktop); use `adom-desktop bridge_install` with a local `file://` manifest URL to test your changes against a real GUI. 2. **Open a PR** against `main`. The CI in `.github/workflows/validate.yml` checks that `bridge.json` is valid + verb prefixes look right + the BRIDGE_VERSION was bumped vs. main. 3. **Maintainer reviews + merges.** No squash-merge — we preserve your authored commits.-4. **Maintainer tags + ships.** A tag `v<X.Y.Z>` triggers `release-bridge.sh` on a maintainer's box, which uploads the new zip + manifest to [the Adom Wiki](https://wiki-ufypy5dpx93o.adom.cloud/apps/adom-desktop-bridges). Anyone running Adom Desktop v1.7.19+ picks it up within 4 hours or on the next `adom-desktop refresh_bridges`.+4. **Maintainer ships.** A maintainer bumps `BRIDGE_VERSION` + `bridge.json` together, builds the release zip, and publishes it to the canonical page, [wiki.adom.inc/adom/adom-desktop-fusion-bridge](https://wiki.adom.inc/adom/adom-desktop-fusion-bridge): repo files (manifest, `bridge.json`, `BRIDGE_VERSION`, sources) via the page files API, and the binary zip via `adom-wiki release upload adom/adom-desktop-fusion-bridge <ver> <zip>`. See PUBLISHING.md for the exact ritual. Anyone running Adom Desktop v1.7.19+ picks it up within 4 hours or on the next `adom-desktop refresh_bridges`. -We DON'T auto-ship from GitHub Actions today. Reason: `release-bridge.sh` needs an Adom Wiki API token, and we keep that secret on maintainer machines rather than in GH Actions secrets. The community trust model around auto-publishing community PRs to a shared wiki space is part of a separate effort ("Chunk D" in adom-desktop's TODO.md) — comment on an issue if you want to help design that.+We DON'T auto-ship from GitHub Actions today. Reason: publishing needs an Adom Wiki API token, and we keep that secret on maintainer machines rather than in GH Actions secrets. The community trust model around auto-publishing community PRs to a shared wiki space is part of a separate effort ("Chunk D" in adom-desktop's TODO.md) — comment on an issue if you want to help design that.  ## Bridge.json schema -See [the SDK guide on the Adom Wiki](https://wiki-ufypy5dpx93o.adom.cloud/apps/adom-desktop-bridges) for the authoritative schema. Quick summary:+See [the SDK guide on the Adom Wiki](https://wiki.adom.inc/adom/adom-desktop-bridges) for the authoritative schema. Quick summary:  - `manifest_version: 1` - `name` — must match the directory name in adom-desktop's `plugins/` (when bundled)