diff --git a/mod_mix/README.markdown b/mod_mix/README.markdown
index 8f0d94e..6693d50 100644
--- a/mod_mix/README.markdown
+++ b/mod_mix/README.markdown
@@ -1,26 +1,46 @@
-This module enables prosody to use Mediated Information Exchange with
-the following protocols being supported:
+---
+labels:
+- 'Stage-Alpha'
+summary: 'XEP-0369: Mediated Information eXchange (MIX)'
+...
 
-- MIX-CORE
-- MIX-ADMIN
+Introduction
+============
 
-Note that this module does not provice MIX-PAM, which is need for MIX clients to function.
+This module implements [XEP-0369: Mediated Information eXchange (MIX)](https://xmpp.org/extensions/xep-0369.html).
 
-| Option | Description | Default |
-| --- | --- | --- |
-| `default_description` | The default description of a newly created channel | `""` |
-| `default_name` | The default name of a newly created channel | `"MIX Channel"` |
-| `service_name` | The name of the MIX service during service discovery | `"Prosody MIX Service"` |
-| `restrict_channel_creation` | Controls who can create channels | `"local"` |
+Configuration
+=============
 
-`restrict_channel_creation` has two modes of operation:
+```
+VirtualHost "example.org"
+    -- [...]
+
+    disco_items = {
+        -- [...]
+        { "mix.example.org", "My cool mix service" };
+        -- [...]
+    }
+
+    -- [...]
+
+Component "mix.example.org" "mix"
+    service_name = "My cool mix service"
+    restrict_channel_creation = { "example.org" }
+    default_name = "Awesome new channel"
+    default_description = "A cool new channel that someone made"
+```
+
+`restrict_channel_creation` controls who can create channels on this MIX host
+and has two modes of operation:
 
 - `"local"`: Only local users can create channels, e.g. `romeo@example.org` can create channels on `mix.example.org`, but not `juliet@example.net`
 - `{ ... }`: If the value is a table, then one can list hosts or users that are allowed to create channels
 
-## Example configuration
-```lua
-Component "mix.example.org" "mix"
-    service_name = "My name Jeff"
-    restrict_channel_creation = { "exmaple_org" }
-```
+Compatibility
+=============
+
+  ----- --------
+  trunk Untested
+  0.11  Works
+  ----- --------