Documentation for asterisk_mbox component (#2908)

* Add asterisk_mbox documentation

* Bad filename

* Capitalization error

* Update documentation based on changes to the mailbox implementation

* Typos as per review

* Remove mailbox sensor, since the functionality is included in the mailbox component.  Added ha_version to each file since the code has now been merged.

source/_components/asterisk_mbox.markdown

@@ -0,0 +1,42 @@
+---
+layout: page
+title: "Asterisk Voicemail"
+description: "Instructions how to integrate your existing Asterisk voicemail within Home Assistant."
+date: 2017-06-30 18:30
+sidebar: true
+comments: false
+sharing: true
+footer: true
+ha_category: Other
+ha_version: 0.51
+ha_iot_class: "Local Push"
+---
+
+The Asterisk Voicemail integration for Home Assistant allows you to view, listen-to, and delete voicemails from a Asterisk voicemail mailbox.  The component includes a panel on the frontend that provides caller-id and speech-to-text transcription (using Google's API) of messages in addition to playback and message deletion.  There is also an included sensor that provides an indication of the number of available messages.  There is no requirement that the Asterisk PBX and Home Assistant are running on the same machine.
+
+To enable the component, configuration is required in both Home Assistant as well as on the Asterisk server.
+
+First follow the [Asterisk PBX configuration guide](/docs/asterisk_mbox) to setup the necessary server on the Asterisk PBX server (this is necessary even if Asterisk and Home Assistant are running on the same server)
+
+Once that is complete, add the the following entry `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+asterisk_mbox:
+    password: ASTERISK_PBX_PASSWORD
+    host: ASTERISK_PBX_SERVER_IP_ADDRESS
+    port: ASTERISK_PBX_SERVER_PORT
+```
+
+This will add a new 'Mailbox' side-panel, as well as a sensor to indicate # of messages available.
+
+Configuration variables:
+
+- **password** (*Required*): The password that was set during Asterisk PBX confguration
+- **host** (*Required*): The ip-address of the server that is running the Asterisk PBX
+- **port** (*Required*): The port on the Asterisk PBX server that was configured during Asterisk PBX confguration
+
+<p class='note warning'>
+Communication between the Asterisk PBX server and the Home Assistant server is password-protected, but the data transmission is not encrypted.  It is recommended to only use this component when communication will be contained within a local area network.
+</p>
+

source/_components/demo.markdown

@@ -31,6 +31,7 @@ Available demo platforms:
 - [Switch](/components/switch/) (`switch`)
 - [Text-to-speech](/components/tts/) (`tts`)
 - [Weather](/components/weather/) (`weather`)
+- [Mailbox](/components/mailbox/) (`mailbox`)
 
 To integrate a demo platform in Home Assistant, add the following section to your `configuration.yaml` file:
 

source/_components/mailbox.asterisk_mbox.markdown

@@ -0,0 +1,15 @@
+---
+layout: page
+title: "Asterisk Voicemail Mailbox"
+description: "Instructions how to integrate an Asterisk Voicemail within Home Assistant."
+date: 2017-06-30 18:30
+sidebar: true
+comments: false
+sharing: true
+footer: true
+ha_category: Mailbox
+ha_version: 0.51
+---
+
+The Asterisk Voicemail Mailbox provides visual and audio access to voicemail on the Asterisk PBX server.  This mailbox is enabled automatically through the [Asterisk Voicemail component](/components/asterisk_mbox) configuration.
+

source/_components/mailbox.markdown

@@ -0,0 +1,18 @@
+---
+layout: page
+title: "Mailbox"
+description: "Instructions how to setup your mailboxes with Home Assistant."
+date: 2017-06-30 18:30
+sidebar: true
+comments: false
+sharing: true
+ha_version: 0.51
+footer: true
+---
+
+Mailboxes provide an list of messages with short information about each.  Mailbox messages appear on a separate panel in the frontend.
+
+Home Assistant currently supports only the [Asterisk Vaoicemail](/component/mailbox.asterisk_mbox) mailbox.
+
+Each mailbox also provides an entity to indicate the number of messages available on the main page.
+