From 5563ab3215638c7b528f0e585cb1a673f1c38d56 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Tue, 16 Sep 2025 18:42:32 -0700 Subject: [PATCH 1/2] build: run the docgen command with make tag release --- Makefile | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Makefile b/Makefile index f2f6b74d..e6d9c24c 100644 --- a/Makefile +++ b/Makefile @@ -78,12 +78,13 @@ build-snapshot: clean .PHONY: tag tag: git diff --quiet --cached - git diff --quiet docs/guides/installing-the-slack-cli-*.md + git diff --quiet @if echo "$(RELEASE_VERSION)" | grep -q '^v'; then \ echo "Error: Release version should not begin with a version prefix."; \ exit 1; \ fi @printf "$(FONT_BOLD)Updating Docs$(FONT_RESET)\n" + ./bin/slack docgen ./docs/reference sed -i.bak -E "s#slack_cli_[0-9]+\.[0-9]+\.[0-9]+_macOS_arm64\.tar\.gz#slack_cli_$(RELEASE_VERSION)_macOS_arm64.tar.gz#" docs/guides/installing-the-slack-cli-for-mac-and-linux.md sed -i.bak -E "s#slack_cli_[0-9]+\.[0-9]+\.[0-9]+_macOS_amd64\.tar\.gz#slack_cli_$(RELEASE_VERSION)_macOS_amd64.tar.gz#" docs/guides/installing-the-slack-cli-for-mac-and-linux.md sed -i.bak -E "s#slack_cli_[0-9]+\.[0-9]+\.[0-9]+_linux_64-bit\.tar\.gz#slack_cli_$(RELEASE_VERSION)_linux_64-bit.tar.gz#" docs/guides/installing-the-slack-cli-for-mac-and-linux.md @@ -94,6 +95,7 @@ tag: rm docs/guides/installing-the-slack-cli-for-mac-and-linux.md.bak rm docs/guides/installing-the-slack-cli-for-windows.md.bak @printf "$(FONT_BOLD)Git Add$(FONT_RESET)\n" + git add docs/reference git add docs/guides/installing-the-slack-cli-for-mac-and-linux.md git add docs/guides/installing-the-slack-cli-for-windows.md @printf "$(FONT_BOLD)Git Commit$(FONT_RESET)\n" From c4d569f74bd4021b4c7cb56918ac9b97681b4a21 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Tue, 16 Sep 2025 21:58:34 -0700 Subject: [PATCH 2/2] fix: avoid automatic updates when generating documentation Co-authored-by: Michael Brooks --- Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Makefile b/Makefile index e6d9c24c..85cdf323 100644 --- a/Makefile +++ b/Makefile @@ -84,7 +84,7 @@ tag: exit 1; \ fi @printf "$(FONT_BOLD)Updating Docs$(FONT_RESET)\n" - ./bin/slack docgen ./docs/reference + ./bin/slack docgen ./docs/reference --skip-update sed -i.bak -E "s#slack_cli_[0-9]+\.[0-9]+\.[0-9]+_macOS_arm64\.tar\.gz#slack_cli_$(RELEASE_VERSION)_macOS_arm64.tar.gz#" docs/guides/installing-the-slack-cli-for-mac-and-linux.md sed -i.bak -E "s#slack_cli_[0-9]+\.[0-9]+\.[0-9]+_macOS_amd64\.tar\.gz#slack_cli_$(RELEASE_VERSION)_macOS_amd64.tar.gz#" docs/guides/installing-the-slack-cli-for-mac-and-linux.md sed -i.bak -E "s#slack_cli_[0-9]+\.[0-9]+\.[0-9]+_linux_64-bit\.tar\.gz#slack_cli_$(RELEASE_VERSION)_linux_64-bit.tar.gz#" docs/guides/installing-the-slack-cli-for-mac-and-linux.md