From 9761a2458dfb9870f53660afa8a172672559157e Mon Sep 17 00:00:00 2001 From: Daniel Graham Date: Fri, 17 Apr 2026 14:07:06 -0700 Subject: [PATCH 1/5] draft PR --- ...itude-docs-analytics-browser-changelog.yml | 80 +++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 .github/workflows/amplitude-docs-analytics-browser-changelog.yml diff --git a/.github/workflows/amplitude-docs-analytics-browser-changelog.yml b/.github/workflows/amplitude-docs-analytics-browser-changelog.yml new file mode 100644 index 000000000..a60917eb8 --- /dev/null +++ b/.github/workflows/amplitude-docs-analytics-browser-changelog.yml @@ -0,0 +1,80 @@ +# Opens an empty draft PR on amplitude/amplitude-docs (blank body) for manual follow-up. +# Future iteration: run Cursor agent + skill to fill changelog updates. +# +# Secret: AMPLITUDE_DOCS_GITHUB_TOKEN — PAT or fine-grained token with contents:write and +# pull-requests:write on amplitude/amplitude-docs (HTTPS checkout; same repo as +# git@github.com:amplitude/amplitude-docs.git). +# +# Optional repository variable: AMPLITUDE_DOCS_DEFAULT_BRANCH (default: main) +# +name: Amplitude Docs — analytics-browser changelog + +on: + workflow_dispatch: + manual: + +permissions: + contents: read + pull-requests: write + +jobs: + open-empty-pr: + runs-on: ubuntu-latest + permissions: + contents: read + env: + DOCS_DIR: amplitude-docs + DOCS_REPO: amplitude/amplitude-docs + GH_TOKEN: ${{ secrets.AMPLITUDE_DOCS_GITHUB_TOKEN }} + + steps: + - name: Check out amplitude-docs + uses: actions/checkout@f43a0e5ff2bd294095638e18286ca9a3d1956744 # v3 + with: + repository: amplitude/amplitude-docs + token: ${{ secrets.AMPLITUDE_DOCS_GITHUB_TOKEN }} + path: ${{ env.DOCS_DIR }} + + - name: Push empty commit and open draft PR + working-directory: ${{ env.DOCS_DIR }} + env: + BASE_BRANCH: ${{ vars.AMPLITUDE_DOCS_DEFAULT_BRANCH || 'main' }} + run: | + set -euo pipefail + git config user.name "github-actions[bot]" + git config user.email "41898282+github-actions[bot]@users.noreply.github.com" + + BRANCH="ci/analytics-browser-changelog-${{ github.run_id }}" + git checkout -b "$BRANCH" + git commit --allow-empty -m "chore: draft PR placeholder" + git push -u origin "$BRANCH" + + # GitHub requires a non-empty title; use zero-width space as a blank placeholder (edit in the UI). + TITLE=$'\u200b' + PR_LOG="$(mktemp)" + gh pr create \ + --repo "${{ env.DOCS_REPO }}" \ + --base "${BASE_BRANCH}" \ + --head "$BRANCH" \ + --draft \ + --title "$TITLE" \ + --body "" \ + --reviewer amplitude/dx \ + 2>&1 | tee "$PR_LOG" + + PR_URL="$(grep -oE 'https://github\.com/[^[:space:]]+/pull/[0-9]+' "$PR_LOG" | head -n1)" + rm -f "$PR_LOG" + if [ -z "$PR_URL" ]; then + echo "::error::Could not parse pull request URL from gh output." + exit 1 + fi + + echo "PR_URL=${PR_URL}" >> "$GITHUB_ENV" + echo "Created pull request: ${PR_URL}" + { + echo "## Pull request" + echo "${PR_URL}" + echo "" + echo "### Next steps" + echo "Edit the PR title and description, push commits to this branch, then mark the PR ready for review when you are done." + } >> "$GITHUB_STEP_SUMMARY" From 06cd6a9245ceccd6bbeb659989af993b1dae7b66 Mon Sep 17 00:00:00 2001 From: Daniel Graham Date: Fri, 17 Apr 2026 14:08:43 -0700 Subject: [PATCH 2/5] draft PR --- .github/workflows/amplitude-docs-analytics-browser-changelog.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/amplitude-docs-analytics-browser-changelog.yml b/.github/workflows/amplitude-docs-analytics-browser-changelog.yml index a60917eb8..87f824bce 100644 --- a/.github/workflows/amplitude-docs-analytics-browser-changelog.yml +++ b/.github/workflows/amplitude-docs-analytics-browser-changelog.yml @@ -12,6 +12,7 @@ name: Amplitude Docs — analytics-browser changelog on: workflow_dispatch: manual: + pull_request: permissions: contents: read From ca3583dc44e9dbd979693fa3d3566072b3debff2 Mon Sep 17 00:00:00 2001 From: Daniel Graham Date: Fri, 17 Apr 2026 14:09:44 -0700 Subject: [PATCH 3/5] draft PR --- .github/workflows/amplitude-docs-analytics-browser-changelog.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/amplitude-docs-analytics-browser-changelog.yml b/.github/workflows/amplitude-docs-analytics-browser-changelog.yml index 87f824bce..efdf83976 100644 --- a/.github/workflows/amplitude-docs-analytics-browser-changelog.yml +++ b/.github/workflows/amplitude-docs-analytics-browser-changelog.yml @@ -13,6 +13,7 @@ on: workflow_dispatch: manual: pull_request: + types: [opened, synchronize, edited] permissions: contents: read From 4fde76d98c422098d5f4bda96762ad08f51f9f0c Mon Sep 17 00:00:00 2001 From: Daniel Graham Date: Fri, 17 Apr 2026 14:11:30 -0700 Subject: [PATCH 4/5] draft PR --- .github/workflows/amplitude-docs-analytics-browser-changelog.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/.github/workflows/amplitude-docs-analytics-browser-changelog.yml b/.github/workflows/amplitude-docs-analytics-browser-changelog.yml index efdf83976..c84a97271 100644 --- a/.github/workflows/amplitude-docs-analytics-browser-changelog.yml +++ b/.github/workflows/amplitude-docs-analytics-browser-changelog.yml @@ -11,7 +11,6 @@ name: Amplitude Docs — analytics-browser changelog on: workflow_dispatch: - manual: pull_request: types: [opened, synchronize, edited] From 2554076e04510302252e93256f2db6ad301f57f2 Mon Sep 17 00:00:00 2001 From: Daniel Graham Date: Fri, 17 Apr 2026 14:13:04 -0700 Subject: [PATCH 5/5] draft PR --- .../workflows/amplitude-docs-analytics-browser-changelog.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/amplitude-docs-analytics-browser-changelog.yml b/.github/workflows/amplitude-docs-analytics-browser-changelog.yml index c84a97271..f66e1bf2b 100644 --- a/.github/workflows/amplitude-docs-analytics-browser-changelog.yml +++ b/.github/workflows/amplitude-docs-analytics-browser-changelog.yml @@ -26,14 +26,14 @@ jobs: env: DOCS_DIR: amplitude-docs DOCS_REPO: amplitude/amplitude-docs - GH_TOKEN: ${{ secrets.AMPLITUDE_DOCS_GITHUB_TOKEN }} + GH_TOKEN: ${{ secrets.GH_PUBLISH_TOKEN }} steps: - name: Check out amplitude-docs uses: actions/checkout@f43a0e5ff2bd294095638e18286ca9a3d1956744 # v3 with: repository: amplitude/amplitude-docs - token: ${{ secrets.AMPLITUDE_DOCS_GITHUB_TOKEN }} + token: ${{ secrets.GH_PUBLISH_TOKEN }} path: ${{ env.DOCS_DIR }} - name: Push empty commit and open draft PR