From 2bf5ac89fde21706c43bed2c316b661c4c3c8137 Mon Sep 17 00:00:00 2001 From: Zayan Khan Date: Sun, 26 Jul 2026 20:12:08 -0400 Subject: [PATCH 1/4] oauth: remove Examples section pointing at deleted example apps examples/oauth-v2 and examples/oauth-v1 no longer exist in the repository (only openid-connect and socket-mode remain), so both links 404. Co-Authored-By: Claude Fable 5 --- packages/oauth/README.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/packages/oauth/README.md b/packages/oauth/README.md index 5e3eb5f47..33f4e6ac0 100644 --- a/packages/oauth/README.md +++ b/packages/oauth/README.md @@ -388,12 +388,6 @@ const installer = new InstallProvider({ ``` ---- - -### Examples - -* [OAuth Express app](../../examples/oauth-v2/README.md). This example uses [Keyv](https://github.com/lukechilds/keyv) library as an installation store. -* [classic Slack App](../../examples/oauth-v1/README.md). This example uses the built-in installation store --- From 42fa1a6c1f11a11211243088c700cef9ca0085c2 Mon Sep 17 00:00:00 2001 From: Zayan Khan Date: Sun, 26 Jul 2026 20:12:08 -0400 Subject: [PATCH 2/4] docs: remove OAuth examples links to deleted example apps The linked examples/oauth-v2 and examples/oauth-v1 directories were removed from the repository; both GitHub URLs return 404. Co-Authored-By: Claude Fable 5 --- docs/english/oauth.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/docs/english/oauth.md b/docs/english/oauth.md index 042b23861..b963fb10f 100644 --- a/docs/english/oauth.md +++ b/docs/english/oauth.md @@ -463,12 +463,6 @@ const installer = new InstallProvider({ ``` ---- - -## Examples - -* [OAuth Express app](https://github.com/slackapi/node-slack-sdk/tree/main/examples/oauth-v2/README.md). This example uses [Keyv](https://github.com/lukechilds/keyv) library as an installation store. -* [Classic Slack app](https://github.com/slackapi/node-slack-sdk/tree/main/examples/oauth-v1/README.md). This example uses the built-in installation store. --- From a335bb5ba40d3a362e618987048b4c438802f0ae Mon Sep 17 00:00:00 2001 From: Zayan Khan Date: Sun, 26 Jul 2026 20:12:08 -0400 Subject: [PATCH 3/4] docs: fix broken cross-references in migration guides - the requestInterceptor reference was missing the '#' and used a slug that matches no heading; point at the actual section anchor - the socket-mode v3 guide linked ./web-api-v8-migration.md, which does not exist; the guide lives at ../web-api/migrating-web-api-package-to-v8.md Co-Authored-By: Claude Fable 5 --- .../socket-mode/migrating-socket-mode-package-to-v3.md | 2 +- .../migration/web-api/migrating-web-api-package-to-v8.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/english/migration/socket-mode/migrating-socket-mode-package-to-v3.md b/docs/english/migration/socket-mode/migrating-socket-mode-package-to-v3.md index bf8975a25..957c7ec81 100644 --- a/docs/english/migration/socket-mode/migrating-socket-mode-package-to-v3.md +++ b/docs/english/migration/socket-mode/migrating-socket-mode-package-to-v3.md @@ -93,7 +93,7 @@ const client = new SocketModeClient({ ### We've updated the dependency on `@slack/web-api@^8` -This package now uses `@slack/web-api@^8` internally. If you're passing `clientOptions`, the web-api breaking changes apply there too. Check the [web-api v8 migration guide](./web-api-v8-migration.md) for details. +This package now uses `@slack/web-api@^8` internally. If you're passing `clientOptions`, the web-api breaking changes apply there too. Check the [web-api v8 migration guide](../web-api/migrating-web-api-package-to-v8.md) for details. ```diff const client = new SocketModeClient({ diff --git a/docs/english/migration/web-api/migrating-web-api-package-to-v8.md b/docs/english/migration/web-api/migrating-web-api-package-to-v8.md index f456a5dfe..d9db4ad9b 100644 --- a/docs/english/migration/web-api/migrating-web-api-package-to-v8.md +++ b/docs/english/migration/web-api/migrating-web-api-package-to-v8.md @@ -337,7 +337,7 @@ function handleError(error: WebAPIHTTPError) { ### We've removed the `RequestConfig` type -The `RequestConfig` type was an alias for axios's `InternalAxiosRequestConfig`. If you were importing it for `requestInterceptor`, [that has also been removed](requestinterceptor-and-requestinterceptor-type-removed). Use a fetch wrapper instead as described above. +The `RequestConfig` type was an alias for axios's `InternalAxiosRequestConfig`. If you were importing it for `requestInterceptor`, [that has also been removed](#weve-removed-the-requestinterceptor-and-requestinterceptor-types). Use a fetch wrapper instead as described above. ```diff -import type { RequestConfig } from '@slack/web-api'; From 18e34df4d2a44ff05516573f9c14b80defab8e14 Mon Sep 17 00:00:00 2001 From: Zayan Khan <108294002+ZayanKhan-12@users.noreply.github.com> Date: Tue, 28 Jul 2026 21:05:47 -0400 Subject: [PATCH 4/4] Update documentation for OAuth examples and migration guide Removed links to deleted OAuth examples and fixed cross-references in the migration guide. --- .changeset/sweet-badgers-remain.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 .changeset/sweet-badgers-remain.md diff --git a/.changeset/sweet-badgers-remain.md b/.changeset/sweet-badgers-remain.md new file mode 100644 index 000000000..35ac6687e --- /dev/null +++ b/.changeset/sweet-badgers-remain.md @@ -0,0 +1,5 @@ +--- +"@slack/oauth": patch +--- + +docs: remove links to deleted OAuth examples; fix migration-guide cross-references