Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

ci: a release deploys the documentation it just made true

yhh52a12bb52bf9
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 2cc1a19fe..a08d8a40b 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -1,9 +1,17 @@
name: Deploy Documentation
+# The `docs-v*` tag is for a docs-only deploy — a typo fix, a new guide, anything
+# that does not wait for an engine release. A RELEASE deploys them too, by calling
+# this: the site states the version it was built from and links the mirror's
+# `latest/` names, so a release that publishes without redeploying leaves the
+# download section naming the version before it, and every guide written for what
+# just shipped unpublished. That happened with v0.41.0, whose agent guide was
+# committed and then simply not on the site.
on:
push:
tags:
- 'docs-v*'
+ workflow_call:
workflow_dispatch:
permissions:
diff --git a/.github/workflows/release-desktop.yml b/.github/workflows/release-desktop.yml
index 2740c10c1..8d94cacd2 100644
--- a/.github/workflows/release-desktop.yml
+++ b/.github/workflows/release-desktop.yml
@@ -444,3 +444,18 @@ jobs:
secrets: inherit
with:
tag: ${{ github.ref_name }}
+
+ # The site alongside the binaries, for the same reason the mirror is here: both
+ # describe the release that just went out, and a release is the moment they stop
+ # being true. The landing page bakes in desktop/package.json's version and links
+ # the mirror's `latest/` names, so a deploy that lags a release advertises the
+ # previous one — and every guide written for what just shipped sits in the repo,
+ # published nowhere. After `publish`, not beside it: a draft that never became a
+ # release should not move the documentation.
+ docs:
+ needs: publish
+ uses: ./.github/workflows/docs.yml
+ permissions:
+ contents: read
+ pages: write
+ id-token: write