From a9a72c2b5d4a2b6f78e595be639cf18257792846 Mon Sep 17 00:00:00 2001
From: Niloth P <20315308+Niloth-p@users.noreply.github.com>
Date: Thu, 14 Nov 2024 17:27:43 +0530
Subject: [PATCH] integration-docs: Update BigBlueButton for new doc format.

Part of zulip#29592.
---
 .../zerver/integrations/big-blue-button.md    | 41 +++++++++----------
 1 file changed, 19 insertions(+), 22 deletions(-)

diff --git a/templates/zerver/integrations/big-blue-button.md b/templates/zerver/integrations/big-blue-button.md
index 00089e6de9..1116ffab38 100644
--- a/templates/zerver/integrations/big-blue-button.md
+++ b/templates/zerver/integrations/big-blue-button.md
@@ -1,35 +1,32 @@
-Zulip supports using BigBlueButton as its video call video call
-provider. This is currently only possible on self-hosted Zulip
-installations.
+# Zulip BigBlueButton integration
 
-To use the [BigBlueButton](https://bigbluebutton.org/) video call
-integration, you'll need to have a BigBlueButton server and
-configure your zulip server to use that BigBlueButton server.
+Zulip supports using BigBlueButton as its video call provider.
 
-### Configure BigBlueButton server
+!!! warn ""
 
-1. Get the Shared Secret using the `bbb-conf --secret` command on your
-   BigBlueButton Server. See also
-   [BigBlueButton documentation](https://docs.bigbluebutton.org/admin/customize.html#extract-the-shared-secret).
+    **Note:** This is currently only possible on self-hosted Zulip installations, and you'll need a BigBlueButton server.
 
-1. Get the URL to your BigBlueButton API. The URL has the form of
-   `https://bigbluebutton.example.com/bigbluebutton/` and can also be
-   found using the `bbb-conf --secret` command.
+{start_tabs}
 
-### Configure zulip server
+1. Run `bbb-conf --secret` on your BigBlueButton server, and get
+   the shared secret and the API URL.
 
-1. In `/etc/zulip/zulip-secrets.conf`, set `big_blue_button_secret`
-   as your BigBlueButton Server's shared secret.
+1. In `/etc/zulip/zulip-secrets.conf`, set `big_blue_button_secret` to the obtained shared secret.
 
-1. In `/etc/zulip/settings.py`, set `BIG_BLUE_BUTTON_URL`
-   as your BigBlueButton Server's API URL.
+1. In `/etc/zulip/settings.py`, set `BIG_BLUE_BUTTON_URL` to your
+   BigBlueButton server's API URL.
 
 1. Restart the Zulip server with
    `/home/zulip/deployments/current/scripts/restart-server`.
 
-### Using BigBlueButton
+1. Select BigBlueButton as the organization's [video call provider][video call provider].
 
-1. Select BigBlueButton as the organization's [video call provider](/help/start-a-call#changing-your-organizations-video-call-provider).
+{end_tabs}
 
-1. Zulip's [call button](/help/start-a-call) will now create meetings
-   using BigBlueButton.
+You're done! Zulip's [call button](/help/start-a-call) will now create meetings using BigBlueButton.
+
+### Related documentation
+
+[Configuring your BigBlueButton server](https://docs.bigbluebutton.org/administration/customize/#other-configuration-changes)
+
+[video call provider]: /help/start-a-call#changing-your-organizations-video-call-provider