Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

integration-docs: Update Codebase for new doc format. 

Part of zulip#29592.
This commit is contained in:
Niloth P 2024-11-14 17:28:15 +05:30
parent 43c8eb9796
commit c7d42665a9
1 changed files with 25 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
templates/zerver/integrations/codebase.md
View File

@ -1,9 +1,16 @@
# Zulip Codebase integration
Get Codebase notifications in Zulip! Get Codebase notifications in Zulip!
1. First, create the streams you’d like to use for Codebase notifications. There {start_tabs}
will be two types of messages: commit-related updates and issue-related
updates. We recommend naming the streams `codebase` and `tickets`, respectively. 1. [Create the channels](/help/create-a-channel) you’d like to use for
After creating these streams, make sure to subscribe all interested parties. Codebase notifications. There will be two types of messages:
commit-related updates and issue-related updates.
!!! tip ""
We recommend naming the channels `codebase` and `tickets`, respectively.
1. {!create-an-incoming-webhook.md!} 1. {!create-an-incoming-webhook.md!}
@ -11,8 +18,10 @@ Get Codebase notifications in Zulip!
1. {!change-zulip-config-file.md!} 1. {!change-zulip-config-file.md!}
You may also need to update the value of `ZULIP_TICKETS_STREAM_NAME` and ```
`ZULIP_COMMITS_STREAM_NAME`. ZULIP_TICKETS_STREAM_NAME = "<Your channel for issue-related updates>"
ZULIP_COMMITS_STREAM_NAME = "<Your channel for commit-related updates>"
```
1. Go to your Codebase settings, and click on **My Profile**. Under 1. Go to your Codebase settings, and click on **My Profile**. Under
**API Credentials**, you will find your API key and username. **API Credentials**, you will find your API key and username.
@ -24,16 +33,19 @@ Get Codebase notifications in Zulip!
CODEBASE_API_KEY = 0123456789abcdef0123456789abcdef CODEBASE_API_KEY = 0123456789abcdef0123456789abcdef
``` ```
Before your first run of the script, you may also want to configure the !!! tip ""
integration to mirror some number of hours of prior Codebase activity:
``` Before your first run of the script, you may also want to configure the
CODEBASE_INITIAL_HISTORY_HOURS = 10 integration to mirror some number of hours of prior Codebase activity: `CODEBASE_INITIAL_HISTORY_HOURS = 10`
```
1. Run the `/usr/local/share/zulip/integrations/codebase/zulip_codebase_mirror` 1. Run the `/usr/local/share/zulip/integrations/codebase/zulip_codebase_mirror`
script. If needed, this script may be restarted, and it will automatically script.
resume from when it was last running.
!!! tip ""
On restarts, this script will automatically resume from last runtime.
{end_tabs}
{!congrats.md!} {!congrats.md!}