integration-docs: Update branch filtering instructions.

Updated the Git-related integrations that support branch filtering:
- Removed the branch-filtering configuration option, and its macro.
- Added a new macro that integrates the branch-filtering instruction
with the Generate-URL step.

The new macro `generate-webhook-url-with-branch-filtering` builds off of
the `generate-webhook-url-basic` macro, adding only the branch filtering
instruction. But, it does not re-use the macro, instead duplicates it,
to avoid the newline break that would be added otherwise.
This commit is contained in:
Niloth P
2025-03-02 10:57:00 +05:30
committed by Tim Abbott
parent 136b852749
commit 8f564b2053
9 changed files with 10 additions and 36 deletions

View File

@@ -0,0 +1,3 @@
Decide where to send {{ integration_display_name }} notifications, and
[generate the integration URL](/help/generate-integration-url). You'll be
able to configure which branches you'll receive notifications from.

View File

@@ -1,3 +0,0 @@
* You can limit the branches you receive notifications for by
specifying them in a comma-separated list appended to the generated
URL, e.g., `&branches=main,development`.

View File

@@ -6,7 +6,7 @@ Get Azure DevOps notifications in Zulip!
1. {!create-an-incoming-webhook.md!} 1. {!create-an-incoming-webhook.md!}
1. {!generate-webhook-url-basic.md!} 1. {!generate-webhook-url-with-branch-filtering.md!}
1. Go to your project on Azure DevOps, click on the **Project 1. Go to your project on Azure DevOps, click on the **Project
settings** in the bottom left corner and select **Service settings** in the bottom left corner and select **Service
@@ -28,10 +28,6 @@ Get Azure DevOps notifications in Zulip!
{!event-filtering-additional-feature.md!} {!event-filtering-additional-feature.md!}
### Configuration options
{!git-branches-additional-feature.md!}
### Related documentation ### Related documentation
{!webhooks-url-specification.md!} {!webhooks-url-specification.md!}

View File

@@ -12,7 +12,7 @@ Bitbucket Server click [here](./bitbucket3).
1. {!create-an-incoming-webhook.md!} 1. {!create-an-incoming-webhook.md!}
1. {!generate-webhook-url-basic.md!} 1. {!generate-webhook-url-with-branch-filtering.md!}
1. On your repository's web page, go to **Settings**. Select 1. On your repository's web page, go to **Settings**. Select
**Webhooks**, and then click **Add webhook**. **Webhooks**, and then click **Add webhook**.
@@ -30,10 +30,6 @@ Bitbucket Server click [here](./bitbucket3).
{!event-filtering-additional-feature.md!} {!event-filtering-additional-feature.md!}
### Configuration options
{!git-branches-additional-feature.md!}
### Related documentation ### Related documentation
{!webhooks-url-specification.md!} {!webhooks-url-specification.md!}

View File

@@ -12,7 +12,7 @@ Bitbucket Cloud (SAAS service) click [here](./bitbucket2).
1. {!create-an-incoming-webhook.md!} 1. {!create-an-incoming-webhook.md!}
1. {!generate-webhook-url-basic.md!} 1. {!generate-webhook-url-with-branch-filtering.md!}
1. On your repository's web page, go to **Settings**. Select 1. On your repository's web page, go to **Settings**. Select
**Webhooks**, and then click **Add webhook**. **Webhooks**, and then click **Add webhook**.
@@ -30,10 +30,6 @@ Bitbucket Cloud (SAAS service) click [here](./bitbucket2).
{!event-filtering-additional-feature.md!} {!event-filtering-additional-feature.md!}
### Configuration options
{!git-branches-additional-feature.md!}
### Related documentation ### Related documentation
{!webhooks-url-specification.md!} {!webhooks-url-specification.md!}

View File

@@ -6,7 +6,7 @@ Receive Gitea notifications in Zulip!
1. {!create-an-incoming-webhook.md!} 1. {!create-an-incoming-webhook.md!}
1. {!generate-webhook-url-basic.md!} 1. {!generate-webhook-url-with-branch-filtering.md!}
1. Go to your repository on Gitea and click on **Settings**. Select 1. Go to your repository on Gitea and click on **Settings**. Select
**Webhooks** on the left sidebar, and click **Add Webhook**. **Webhooks** on the left sidebar, and click **Add Webhook**.
@@ -22,10 +22,6 @@ Receive Gitea notifications in Zulip!
![](/static/images/integrations/gitea/001.png) ![](/static/images/integrations/gitea/001.png)
### Configuration options
{!git-branches-additional-feature.md!}
### Related documentation ### Related documentation
{!webhooks-url-specification.md!} {!webhooks-url-specification.md!}

View File

@@ -6,7 +6,7 @@ Receive GitLab notifications in Zulip!
1. {!create-an-incoming-webhook.md!} 1. {!create-an-incoming-webhook.md!}
1. {!generate-webhook-url-basic.md!} 1. {!generate-webhook-url-with-branch-filtering.md!}
1. Go to your repository on GitLab and click **Settings** on the left 1. Go to your repository on GitLab and click **Settings** on the left
sidebar. Click on **Integrations**. sidebar. Click on **Integrations**.
@@ -39,8 +39,6 @@ Receive GitLab notifications in Zulip!
contain the merge request ID by adding `&use_merge_request_title=false` contain the merge request ID by adding `&use_merge_request_title=false`
to the generated URL. to the generated URL.
{!git-branches-additional-feature.md!}
### Related documentation ### Related documentation
{!webhooks-url-specification.md!} {!webhooks-url-specification.md!}

View File

@@ -6,7 +6,7 @@ Receive Gogs notifications in Zulip!
1. {!create-an-incoming-webhook.md!} 1. {!create-an-incoming-webhook.md!}
1. {!generate-webhook-url-basic.md!} 1. {!generate-webhook-url-with-branch-filtering.md!}
1. Go to your repository on Gogs and click on **Settings**. Select 1. Go to your repository on Gogs and click on **Settings**. Select
**Webhooks** on the left sidebar, and click **Add Webhook**. **Webhooks** on the left sidebar, and click **Add Webhook**.
@@ -24,10 +24,6 @@ Receive Gogs notifications in Zulip!
{!event-filtering-additional-feature.md!} {!event-filtering-additional-feature.md!}
### Configuration options
{!git-branches-additional-feature.md!}
### Related documentation ### Related documentation
{!webhooks-url-specification.md!} {!webhooks-url-specification.md!}

View File

@@ -6,7 +6,7 @@ Get RhodeCode notifications in Zulip!
1. {!create-an-incoming-webhook.md!} 1. {!create-an-incoming-webhook.md!}
1. {!generate-webhook-url-basic.md!} 1. {!generate-webhook-url-with-branch-filtering.md!}
1. From your repository on RhodeCode, open the **Repository Settings** tab. 1. From your repository on RhodeCode, open the **Repository Settings** tab.
Select **Integrations**, click on **Create new integration**, and Select **Integrations**, click on **Create new integration**, and
@@ -24,10 +24,6 @@ Get RhodeCode notifications in Zulip!
{!event-filtering-additional-feature.md!} {!event-filtering-additional-feature.md!}
### Configuration options
{!git-branches-additional-feature.md!}
### Related documentation ### Related documentation
{!webhooks-url-specification.md!} {!webhooks-url-specification.md!}