zulip/templates/zerver/integrations/git.md
David Rosa 620854d437 integrations: Add incoming webhook macro to relevant docs.
Several integration docs instruct the user to create a bot, but don't
specify that the type of bot should be "Incoming webhook".

Renames create-a-bot.md -> create-an-incoming-webhook.md for clarity,
and replaces all incomplete instructions with this macro.
Renames bot_types.png -> bot_types_incoming_webhook.png and updates
the image with a screenshot of the latest UI.
2022-09-09 16:31:33 -07:00

32 lines
952 B
Markdown

Get Zulip notifications for your Git repositories!
1. {!create-an-incoming-webhook.md!}
1. {!download-python-bindings.md!}
1. {!create-stream.md!}
1. {!change-zulip-config-file.md!}
You may also need to change the value of `STREAM_NAME`.
You can specify the branches that will be used for notifications by modifying
the `commit_notice_destination` function. By default,
pushes to the `main`, `master`, and `test-post-receive` branches will result in a
notification.
1. Symlink `/usr/local/share/zulip/integrations/git/zulip_git_config.py`
to the `.git/hooks` directory of your Git repository.
1. Symlink `/usr/local/share/zulip/integrations/git/post-receive`
to the `.git/hooks` directory of your Git repository.
!!! tip ""
You can test the plugin without changing your `main` branch by
pushing to the `test-post-receive` branch.
{!congrats.md!}
![Git bot message](/static/images/integrations/git/001.png)