mod_pubsub_github/README.wiki
changeset 1786 29f3d6b7ad16
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_pubsub_github/README.wiki	Mon Aug 24 16:43:56 2015 +0200
@@ -0,0 +1,32 @@
+#summary Publish Github commits over pubsub
+#labels Stage-Beta
+
+= Introduction =
+
+This module accepts Github web hooks and publishes them to a local pubsub component for XMPP clients to subscribe to.
+
+Entries are pushed as Atom payloads.
+
+= Configuration =
+
+Load the module on a pubsub component:
+
+{{{
+Component "pubsub.example.com" "pubsub"
+    modules_enabled = { "pubsub_github" }
+}}}
+
+The module also takes the following config options:
+
+|| *Name* || *Default* || *Description* ||
+|| github_node || "github" || The pubsub node to publish commits on. ||
+
+The URL for Github to post to would be either:
+
+  * http://pubsub.example.com:5280/pubsub_github
+  * https://pubsub.example.com:5281/pubsub_github
+
+If your HTTP host doesn't match the pubsub component's address, you will need to inform Prosody. For more info see Prosody's [https://prosody.im/doc/http#virtual_hosts HTTP server documentation].
+
+= Compatibility =
+|| 0.9 || Works ||
\ No newline at end of file