diff --git a/zerver/webhooks/semaphore/doc.md b/zerver/webhooks/semaphore/doc.md
index 8b98492343..462044bc5e 100644
--- a/zerver/webhooks/semaphore/doc.md
+++ b/zerver/webhooks/semaphore/doc.md
@@ -1,22 +1,30 @@
+# Zulip Semaphore integration
+
 Get Zulip notifications for your Semaphore builds!
 
+{start_tabs}
+
 1. {!create-channel.md!}
 
 1. {!create-an-incoming-webhook.md!}
 
-1. {!generate-integration-url.md!}
+1. {!generate-webhook-url-basic.md!}
 
-1. In Semaphore 2.0, under **Configuration** select **Notifications**. Click on
-   **Create New Notification**. Add the URL constructed above to the Webhook
-   **Endpoint** field.
+1. In the **Configuration** section of the sidebar in Semaphore, select
+   **Notifications**. Click on **Create New Notification**.
 
-    If you are using Semaphore Classic, in your Semaphore project, go to
-   **Project settings**, and select the **Notifications** tab. Click on
-   **Webhooks**, and click **+ Add Webhook**.
+1. Add a name for the notification, such as `Zulip`, and configure any
+   rules you'd like for the notifications. Add the URL generated above
+   to the Webhook **Endpoint** field, and click **Save Changes**.
 
-1. Set **URL** to the URL constructed above, and click
-   **Save Settings**.
+{end_tabs}
 
 {!congrats.md!}
 
 ![](/static/images/integrations/semaphore/001.png)
+
+{!event-filtering-additional-feature.md!}
+
+### Related documentation
+
+{!webhooks-url-specification.md!}