mirror of
				https://github.com/zulip/zulip.git
				synced 2025-11-03 21:43:21 +00:00 
			
		
		
		
	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:
		@@ -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.
 | 
				
			||||||
@@ -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`.
 | 
					 | 
				
			||||||
@@ -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!}
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -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!}
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -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!}
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -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!
 | 
				
			|||||||
 | 
					
 | 
				
			||||||

 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Configuration options
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
{!git-branches-additional-feature.md!}
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Related documentation
 | 
					### Related documentation
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{!webhooks-url-specification.md!}
 | 
					{!webhooks-url-specification.md!}
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -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!}
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -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!}
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -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!}
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user