From c35de3f0d8d22e4ba8c2d37742963822c9b6a50d Mon Sep 17 00:00:00 2001 From: Lenny Chen Date: Fri, 10 Jul 2026 17:07:37 -0700 Subject: [PATCH 1/3] ci: wire post-process-cli-docs.js into CLI docs update workflow gen-docs (temporalio/cli#1112) stopped emitting the ReleaseNoteHeader banner on cloud CLI pages, assuming this script would add it back, but the workflow never actually called it. Run it after regenerating the command reference so the banner, index.mdx, and sidebars.js stay in sync. --- .github/workflows/update-cli-docs.yml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/.github/workflows/update-cli-docs.yml b/.github/workflows/update-cli-docs.yml index b67a8278d6..5f904dc8bf 100644 --- a/.github/workflows/update-cli-docs.yml +++ b/.github/workflows/update-cli-docs.yml @@ -95,6 +95,14 @@ jobs: git checkout HEAD -- docs/cli/command-reference/index.mdx git checkout HEAD -- docs/cli/command-reference/cloud/index.mdx + - name: Post-process generated CLI docs + working-directory: docs + # gen-docs no longer emits the ReleaseNoteHeader banner on cloud CLI + # pages (that responsibility moved to this script). Also keeps + # command-reference/index.mdx and sidebars.js in sync with whatever + # commands gen-docs produced. + run: node bin/post-process-cli-docs.js + - name: Publish generated docs to documentation repo env: GH_TOKEN: ${{ github.token }} From b82d14cbfed94909305d2b6b1f8e07fa557340c3 Mon Sep 17 00:00:00 2001 From: Lenny Chen Date: Fri, 10 Jul 2026 17:13:35 -0700 Subject: [PATCH 2/3] fix comment: post-process script always owned ReleaseNoteHeader injection gen-docs never emitted that banner, in any version; the script has had that job since it was created, CI just never called it. --- .github/workflows/update-cli-docs.yml | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/.github/workflows/update-cli-docs.yml b/.github/workflows/update-cli-docs.yml index 5f904dc8bf..27e330ebb7 100644 --- a/.github/workflows/update-cli-docs.yml +++ b/.github/workflows/update-cli-docs.yml @@ -97,10 +97,11 @@ jobs: - name: Post-process generated CLI docs working-directory: docs - # gen-docs no longer emits the ReleaseNoteHeader banner on cloud CLI - # pages (that responsibility moved to this script). Also keeps - # command-reference/index.mdx and sidebars.js in sync with whatever - # commands gen-docs produced. + # gen-docs has never emitted the ReleaseNoteHeader banner on cloud CLI + # pages; injecting it (and keeping command-reference/index.mdx and + # sidebars.js in sync) has always been this script's job. It was just + # never wired into this workflow, so it only took effect on past + # regens where someone ran it locally before committing. run: node bin/post-process-cli-docs.js - name: Publish generated docs to documentation repo From 7d39c4bab42880447cec0e80a2fad63fa48cafe5 Mon Sep 17 00:00:00 2001 From: Lenny Chen Date: Fri, 10 Jul 2026 17:14:33 -0700 Subject: [PATCH 3/3] simplify comment wording --- .github/workflows/update-cli-docs.yml | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/.github/workflows/update-cli-docs.yml b/.github/workflows/update-cli-docs.yml index 27e330ebb7..37c57b697f 100644 --- a/.github/workflows/update-cli-docs.yml +++ b/.github/workflows/update-cli-docs.yml @@ -97,11 +97,9 @@ jobs: - name: Post-process generated CLI docs working-directory: docs - # gen-docs has never emitted the ReleaseNoteHeader banner on cloud CLI - # pages; injecting it (and keeping command-reference/index.mdx and - # sidebars.js in sync) has always been this script's job. It was just - # never wired into this workflow, so it only took effect on past - # regens where someone ran it locally before committing. + # Injects the ReleaseNoteHeader banner into cloud CLI pages and keeps + # command-reference/index.mdx and sidebars.js in sync with the + # generated commands. Not previously called from this workflow. run: node bin/post-process-cli-docs.js - name: Publish generated docs to documentation repo