diff --git a/docs/practices/ci_testing.rst b/docs/practices/ci_testing.rst index 6f20bfc..37b0a97 100644 --- a/docs/practices/ci_testing.rst +++ b/docs/practices/ci_testing.rst @@ -111,20 +111,23 @@ You'll need to create a Slack app. It's not as scary as it sounds! It will have certain permissions to post to particular channels, and will have an associated webhook URL that we'll use to send messages from GitHub to the app. -See `Slack's official documentation `_ +See `Slack's official documentation `_ for setting up an app. We really only need steps 1 and 5, summarized below: -- `Step 1 `_: Create an app +- `Step 1 `_: Create an app from scratch. The ``App Name`` you select here will appear in the slack notificationw we create later, so use something descriptive enough, like: - Slack Bot - CI Reporter -- `Step 5 `_: Add a new +- `Step 5 `_: Add a new webhook and you'll give it permission to post to a specific slack channel. Copy the webook URL. +In the Slack App settings, under "Collaborators", you can add more folks who can manage the App, +and webhooks. We recommend adding someone else with permissions to update the App. + Github workflow step to post to webhook ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~