Slack documentation added

Levent YALCIN
1 parent 352bb972
Showing 1 changed file with 34 additions and 0 deletions Show diff stats
doc/integration/slack.md
@@ -0,0 +1,34 @@
+# Slack integration 
+
+### On Slack
+
+To enable Slack integration you must create an Incoming WebHooks integration on Slack;
+
+
+1. Sign in to [Slack](https://slack.com) (https://YOURSUBDOMAIN.slack.com/services)
+2. Click on the Integrations menu at the top of the page.
+3. Add a new Integration.
+4. Pick Incoming WebHooks 
+5. Choose the channel name you want to send notifications to, in the Settings section
+6. Add Integrations.
+    * Optional step; You can change bot's name and avatar by clicking "change the name of your bot", and "change the icon" after that you have to click "Save settings".
+
+Now, Slack is ready to get external hooks. Before you leave this page don't forget to get the Token that you'll need on GitLab. You can find it by clicking Expand button, located in the "Instructions for creating Incoming WebHooks" section. It's a random alpha-numeric text 24 characters long.
+
+### On GitLab
+
+After Slack is ready we need to setup GitLab. Here are the steps to achieve this.
+
+
+1. Sign in to GitLab
+2. Pick the repository you want.
+3. Navigate to Settings -> Services -> Slack
+4. Fill in your Slack details
+    * Mark as active it
+    * Type your subdomain's prefix (If your subdomain is https://somedomain.slack.com you only have to type the somedomain)
+    * Type in the token you got from Slack
+    * Type in the channel name you want to use (eg. #announcements)
+
+Have fun :)
+
+_P.S. You can set "branch,pushed,Compare changes" as highlight words on your Slack profile settings, so that you can be aware of new commits when somebody pushes them._
...	...	@@ -0,0 +1,34 @@
	1	+# Slack integration
	2	+
	3	+### On Slack
	4	+
	5	+To enable Slack integration you must create an Incoming WebHooks integration on Slack;
	6	+
	7	+
	8	+1. Sign in to [Slack](https://slack.com) (https://YOURSUBDOMAIN.slack.com/services)
	9	+2. Click on the Integrations menu at the top of the page.
	10	+3. Add a new Integration.
	11	+4. Pick Incoming WebHooks
	12	+5. Choose the channel name you want to send notifications to, in the Settings section
	13	+6. Add Integrations.
	14	+ * Optional step; You can change bot's name and avatar by clicking "change the name of your bot", and "change the icon" after that you have to click "Save settings".
	15	+
	16	+Now, Slack is ready to get external hooks. Before you leave this page don't forget to get the Token that you'll need on GitLab. You can find it by clicking Expand button, located in the "Instructions for creating Incoming WebHooks" section. It's a random alpha-numeric text 24 characters long.
	17	+
	18	+### On GitLab
	19	+
	20	+After Slack is ready we need to setup GitLab. Here are the steps to achieve this.
	21	+
	22	+
	23	+1. Sign in to GitLab
	24	+2. Pick the repository you want.
	25	+3. Navigate to Settings -> Services -> Slack
	26	+4. Fill in your Slack details
	27	+ * Mark as active it
	28	+ * Type your subdomain's prefix (If your subdomain is https://somedomain.slack.com you only have to type the somedomain)
	29	+ * Type in the token you got from Slack
	30	+ * Type in the channel name you want to use (eg. #announcements)
	31	+
	32	+Have fun :)
	33	+
	34	+_P.S. You can set "branch,pushed,Compare changes" as highlight words on your Slack profile settings, so that you can be aware of new commits when somebody pushes them._
...	...