From 8e009d8fe820f81dc1b9f5c98cccd19c1210e0ba Mon Sep 17 00:00:00 2001
From: "Juan Picado @jotadeveloper" <juanpicado19@gmail.com>
Date: Tue, 4 Jul 2017 08:00:31 +0200
Subject: [PATCH] (doc): Add notifications documentation

---
 wiki/README.md        |  3 ++-
 wiki/notifications.md | 55 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 57 insertions(+), 1 deletion(-)
 create mode 100644 wiki/notifications.md

diff --git a/wiki/README.md b/wiki/README.md
index 0a6478d97..abd91464d 100644
--- a/wiki/README.md
+++ b/wiki/README.md
@@ -14,10 +14,11 @@ from a fresh look at the code and the outstanding issues. So here we are 🎉
 * [Command Line](cli.md)
 * [Setting up *uplinks*](uplinks.md)
 * [Packages Access](packages.md)
+* [Enable Notifications](notifications.md)
 <!---
 * [Logs](logs.md)
 * [Configure the Web](web.md)
-* [Enable Notifications](notifications.md)
+
 * [Understand the storage](storage.md)
 * [Authorization and access](auth.md)
 * [Installing Plugins](plugins.md)
diff --git a/wiki/notifications.md b/wiki/notifications.md
new file mode 100644
index 000000000..86b205185
--- /dev/null
+++ b/wiki/notifications.md
@@ -0,0 +1,55 @@
+# Notifications
+
+
+Notify was built primarily to use with Slack's Incoming
+webhooks, but will also deliver a simple payload to
+any endpoint. Currently only active for `publish` / `create`
+commands.
+
+## Usage
+
+An example with a **hipchat** hook:
+
+#### Single notification
+
+```yaml
+notify:
+  method: POST
+  headers: [{'Content-Type': 'application/json'}]
+  endpoint: https://usagge.hipchat.com/v2/room/3729485/notification?auth_token=mySecretToken
+  content: '{"color":"green","message":"New package published: * {{ name }}*","notify":true,"message_format":"text"}'
+```
+
+#### Multiple notification
+
+```yaml
+notify:
+  'example-package-1'
+     method: POST
+	 headers: [{'Content-Type': 'application/json'}]
+	 endpoint: https://usagge.hipchat.com/v2/room/3729485/notification?auth_token=mySecretToken
+	 content: '{"color":"green","message":"New package published: * {{ name }}*","notify":true,"message_format":"text"}'
+  'example-package-2'
+     method: POST
+	 headers: [{'Content-Type': 'application/json'}]
+	 endpoint: https://usagge.hipchat.com/v2/room/3729485/notification?auth_token=mySecretToken
+	 content: '{"color":"green","message":"New package published: * {{ name }}*","notify":true,"message_format":"text"}'
+  'example-package-3'
+     method: POST
+	 headers: [{'Content-Type': 'application/json'}]
+	 endpoint: https://usagge.hipchat.com/v2/room/3729485/notification?auth_token=mySecretToken
+	 content: '{"color":"green","message":"New package published: * {{ name }}*","notify":true,"message_format":"text"}'
+	 
+
+```
+
+## Configuration
+
+Property | Type | Required | Support | Description 
+--- | --- | --- | --- | --- | --- 
+method| string | No | all | HTTP verb
+packagePattern| string | No | all | Only run this notification if the package name matches the regular
+headers| array/object | Yes | all | If this endpoint requires specific headers, set them here as an array of key: value objects.
+endpoint| string | Yes | all | set the URL endpoint for this call
+content| string | Yes | all | any Handlebar expressions  
+