From 78f90860b22afb6927df409367ef43557033152b Mon Sep 17 00:00:00 2001 From: David Rosa Date: Wed, 31 Jan 2024 14:22:27 -0800 Subject: [PATCH] help: Update links to Bots and Integrations overview pages. - Cross-link as appropriate, both in related articles and in the content of the pages. Fixes #28758. --- api_docs/integrations-overview.md | 8 ++++++++ help/add-a-bot-or-integration.md | 7 ++++--- help/deactivate-or-reactivate-a-bot.md | 3 ++- help/deactivate-or-reactivate-a-user.md | 2 +- help/edit-a-bot.md | 3 ++- help/generate-integration-url.md | 3 ++- help/include/set-up-integrations.md | 4 ++-- help/request-an-integration.md | 3 ++- help/restrict-bot-creation.md | 7 ++++--- help/restrict-direct-messages.md | 2 +- help/self-hosted-billing.md | 2 +- help/set-up-integrations.md | 3 ++- help/view-all-bots-in-your-organization.md | 2 +- help/view-your-bots.md | 3 ++- 14 files changed, 34 insertions(+), 18 deletions(-) diff --git a/api_docs/integrations-overview.md b/api_docs/integrations-overview.md index 465a3cf9e8..02dd5fe962 100644 --- a/api_docs/integrations-overview.md +++ b/api_docs/integrations-overview.md @@ -67,3 +67,11 @@ us](/help/contact-support) and we'll see what we can do. something that isn't there check out Zulip's [REST endpoints](https://github.com/zulip/zulip/blob/main/zproject/urls.py) or [contact us](/help/contact-support) and we'll help you out. + +## Related articles + +* [Bots overview](/help/bots-overview) +* [Set up integrations](/help/set-up-integrations) +* [Add a bot or integration](/help/add-a-bot-or-integration) +* [Generate integration URL](/help/generate-integration-url) +* [Request an integration](/help/request-an-integration) diff --git a/help/add-a-bot-or-integration.md b/help/add-a-bot-or-integration.md index f5bfecfa68..f1ac70b915 100644 --- a/help/add-a-bot-or-integration.md +++ b/help/add-a-bot-or-integration.md @@ -2,7 +2,7 @@ By default, anyone other than guests can add a bot to a Zulip organization. A bot that sends content to or from another product is often called an -**integration**. +[integration](/help/integrations-overview). Organization administrators can also [restrict bot creation](/help/restrict-bot-creation). Any bot that is added @@ -32,7 +32,7 @@ is visible and available for anyone to use. !!! warn "" - See [bots and integrations](/help/bots-and-integrations) for more information about + See [bots overview](/help/bots-overview) for more information about the various fields. Nearly all third-party integrations should use **Incoming webhook** as the **bot type**. @@ -43,7 +43,8 @@ Depending on the type of bot you're creating, you may need to download its ## Related articles -* [Bots and integrations](/help/bots-and-integrations) +* [Bots overview](/help/bots-overview) +* [Integrations overview](/help/integrations-overview) * [Edit a bot](/help/edit-a-bot) * [Deactivate or reactivate a bot](/help/deactivate-or-reactivate-a-bot) * [Restrict bot creation](/help/restrict-bot-creation) diff --git a/help/deactivate-or-reactivate-a-bot.md b/help/deactivate-or-reactivate-a-bot.md index 3e57ca9db8..52904479ca 100644 --- a/help/deactivate-or-reactivate-a-bot.md +++ b/help/deactivate-or-reactivate-a-bot.md @@ -73,7 +73,8 @@ bot, regardless of who owns them. ## Related articles -* [Bots and integrations](/help/bots-and-integrations) +* [Bots overview](/help/bots-overview) +* [Integrations overview](/help/integrations-overview) * [Add a bot or integration](/help/add-a-bot-or-integration) * [Edit a bot](/help/edit-a-bot) * [Restrict bot creation](/help/restrict-bot-creation) diff --git a/help/deactivate-or-reactivate-a-user.md b/help/deactivate-or-reactivate-a-user.md index 34905eff65..ee8a668512 100644 --- a/help/deactivate-or-reactivate-a-user.md +++ b/help/deactivate-or-reactivate-a-user.md @@ -13,7 +13,7 @@ When you deactivate a user: login and [any other login options](/help/configure-authentication-methods) enabled in your organization. -* The user's [bots](/help/bots-and-integrations) will be deactivated. +* The user's [bots](/help/bots-overview) will be deactivated. * [Email invitations and invite links](/help/invite-new-users) created by the user will be disabled. diff --git a/help/edit-a-bot.md b/help/edit-a-bot.md index 51bbf21a83..7c03fb923e 100644 --- a/help/edit-a-bot.md +++ b/help/edit-a-bot.md @@ -34,7 +34,8 @@ active bot in the organization. ## Related articles -* [Bots and integrations](/help/bots-and-integrations) +* [Bots overview](/help/bots-overview) +* [Integrations overview](/help/integrations-overview) * [Add a bot or integration](/help/add-a-bot-or-integration) * [Deactivate or reactivate a bot](/help/deactivate-or-reactivate-a-bot) * [View all bots in your organization](/help/view-all-bots-in-your-organization) diff --git a/help/generate-integration-url.md b/help/generate-integration-url.md index 8a448b92c3..ec3e4eb5ac 100644 --- a/help/generate-integration-url.md +++ b/help/generate-integration-url.md @@ -56,7 +56,8 @@ integration URL. ## Related articles -* [Bots and integrations](/help/bots-and-integrations) +* [Integrations overview](/help/integrations-overview) +* [Bots overview](/help/bots-overview) * [Add a bot or integration](/help/add-a-bot-or-integration) * [View all bots in your organization](/help/view-all-bots-in-your-organization) * [Request an integration](/help/request-an-integration) diff --git a/help/include/set-up-integrations.md b/help/include/set-up-integrations.md index 9586421b69..843e9d2758 100644 --- a/help/include/set-up-integrations.md +++ b/help/include/set-up-integrations.md @@ -9,5 +9,5 @@ more through [Zapier](/integrations/doc/zapier) and * The [integrations page](/integrations/) has instructions for integrating with each product. * If you don't see an integration you need, you can [request it](/help/request-an-integration). -* You can also [create custom integrations](/api/integrations-overview) using our API. -* Want to learn more? Read about [Zulip bots and integrations](/help/bots-and-integrations). +* You can also create [custom incoming webhook integrations](/api/incoming-webhooks-overview) using our API. +* Want to learn more? Read about [Zulip integrations](/help/integrations-overview). diff --git a/help/request-an-integration.md b/help/request-an-integration.md index a0b7008bde..cd06c848da 100644 --- a/help/request-an-integration.md +++ b/help/request-an-integration.md @@ -18,5 +18,6 @@ issue](https://github.com/zulip/zulip/issues/new). ## Related articles -* [Bots and integrations](/help/bots-and-integrations) +* [Integrations overview](/help/integrations-overview) +* [Bots overview](/help/bots-overview) * [Add a bot or integration](/help/add-a-bot-or-integration) diff --git a/help/restrict-bot-creation.md b/help/restrict-bot-creation.md index 5a06054b52..09524d032e 100644 --- a/help/restrict-bot-creation.md +++ b/help/restrict-bot-creation.md @@ -2,8 +2,8 @@ {!admin-only.md!} -By default, anyone other than guests can [add a bot](/help/add-a-bot-or-integration) or -integration to the Zulip organization. Organization administrators can +By default, anyone other than guests can [add a bot](/help/add-a-bot-or-integration) +or integration to the Zulip organization. Organization administrators can change who is allowed to add bots. ## Configure who can add bots @@ -25,6 +25,7 @@ change who is allowed to add bots. ## Related articles -* [Bots and integrations](/help/bots-and-integrations) +* [Bots overview](/help/bots-overview) +* [Integrations overview](/help/integrations-overview) * [Add a bot or integration](/help/add-a-bot-or-integration) * [Deactivate or reactivate a bot](/help/deactivate-or-reactivate-a-bot) diff --git a/help/restrict-direct-messages.md b/help/restrict-direct-messages.md index 326207c774..3e6651f8b2 100644 --- a/help/restrict-direct-messages.md +++ b/help/restrict-direct-messages.md @@ -3,7 +3,7 @@ {!admin-only.md!} In Zulip, users can exchange direct messages with other users, -[bots](/help/bots-and-integrations) and themselves. Organization +[bots](/help/bots-overview) and themselves. Organization administrators can configure who is allowed to use direct messages. ## Configure who can use direct messages diff --git a/help/self-hosted-billing.md b/help/self-hosted-billing.md index 20671a0d20..87cb378849 100644 --- a/help/self-hosted-billing.md +++ b/help/self-hosted-billing.md @@ -15,7 +15,7 @@ For businesses with more than 10 Zulip users, both the Basic and Business plans include unlimited access to the Mobile Push Notification Service. The Business plan also includes commercial support for dozens of features and -integrations that help businesses take full advantage of their Zulip +[integrations](/help/integrations-overview) that help businesses take full advantage of their Zulip implementation. The minimum purchase is 25 licenses. If your organization requires hands-on support, such as real-time support during diff --git a/help/set-up-integrations.md b/help/set-up-integrations.md index 949c4cd49f..8163e16c70 100644 --- a/help/set-up-integrations.md +++ b/help/set-up-integrations.md @@ -4,7 +4,8 @@ ## Related articles +* [Integrations overview](/help/integrations-overview) * [Setting up your organization](/help/getting-your-organization-started-with-zulip) -* [Bots and integrations](/help/bots-and-integrations) +* [Bots overview](/help/bots-overview) * [Add a bot or integration](/help/add-a-bot-or-integration) * [Add a custom linkifier](/help/add-a-custom-linkifier) diff --git a/help/view-all-bots-in-your-organization.md b/help/view-all-bots-in-your-organization.md index a1113b651e..9ac33042ed 100644 --- a/help/view-all-bots-in-your-organization.md +++ b/help/view-all-bots-in-your-organization.md @@ -15,7 +15,7 @@ Organization [administrators](/help/roles-and-permissions) can also ## Related articles -* [Bots and integrations](/help/bots-and-integrations) +* [Bots overview](/help/bots-overview) * [Add a bot or integration](/help/add-a-bot-or-integration) * [Edit a bot](/help/edit-a-bot) * [Deactivate or reactivate a bot](/help/deactivate-or-reactivate-a-bot) diff --git a/help/view-your-bots.md b/help/view-your-bots.md index 4c29c9874c..4598741bd3 100644 --- a/help/view-your-bots.md +++ b/help/view-your-bots.md @@ -14,7 +14,8 @@ You can also [deactivate](/help/deactivate-or-reactivate-a-bot#deactivate-a-bot) ## Related articles -* [Bots and integrations](/help/bots-and-integrations) +* [Bots overview](/help/bots-overview) +* [Integrations overview](/help/integrations-overview) * [Add a bot or integration](/help/add-a-bot-or-integration) * [Edit a bot](/help/edit-a-bot) * [Deactivate or reactivate a bot](/help/deactivate-or-reactivate-a-bot)