WIP

pages/integrations/slack.md

@@ -7,7 +7,17 @@ Configuring a Slack notification service will authorize access for your desired
 
 Setting up a Notification Service requires Buildkite organization admin access.
 
-## Adding a notification service
+## Adding notification services
+There are two ways to add notification services: workspace-wide and channel-specific. We reccomend using a workspace. This allows you to configure build notifications within your pipeline YAML.
+
+### Adding workspace notification services
+In your [Organization's Notification Settings](https://buildkite.com/organizations/-/services), add a Slack Workspace notification service:
+
+<%= image "buildkite-add-slack-workspace.png", width: 1458/2, height: 142/2, alt: "Screenshot of the 'Add' button for adding a Slack workspace service to Buildkite" %>
+
+This will take you to Slack. Log in, and grant Buildkite the ability to post
+
+### Adding a channel-specific notification service
 
 In your [Organization's Notification Settings](https://buildkite.com/organizations/-/services), add a Slack notification service: