Re-organisation Documentation and Getting started (#2055)

* Split MQTT documentation

* Add more details

* Move content to /docs

* Enable sidebar

* Move content to /docs

* Enable sidebar

* Move content

* Update links

* Remove wizard stuff

* Enable sidebar

* Minor changes

* Move MQTT parts to /docs

* update links

* Update links and sync content

* Fix link

* Enable sidebar

* Remove navigation

* Remove navigation and other minor updates

* Update links

* Add overview page

* Make title linkable

* Update

* Plit content

* Update links

* Rearrange content

* New getting-started section

* Add icons for docs

* Update for new structure

* Update for new structure

* Add docs navigation

* Add docs overview page

* Remove ecosystem navigation

* Add docs and remove other collections

* Move ecosystem to docs

* Remove duplicate files

* Re-add ecosystem overview

* Move to ecosystem

* Fix permission

* Update navigation

* Remove collection

* Move overview to right folder

* Move mqtt to upper level

* Move notebook to ecosystem

* Remove un-used files

* Add one more rectangle for iOS

* Move two parts back from docs and rename Run step

* Remove colon

* update getting-started section

* Add redirect

* Update

* Update navigation

source/_docs/ecosystem/ios.markdown

@@ -0,0 +1,67 @@
+---
+layout: page
+title: "iOS"
+description: "Documentation about the Home Assistant iOS app."
+release_date: 2016-10-24 15:00:00 -0700
+sidebar: true
+comments: false
+sharing: true
+footer: true
+redirect_from: /ecosystem/ios/
+---
+
+The Home Assistant for iOS app offers a companion app for iOS which is deeply integrated into both Home Assistant and iOS. Its basic features include:
+
+* Advanced push notifications
+* Location tracking
+* Basic control of all Home Assistant entities
+* Integration with third party apps
+
+<p class='note warning'>
+Currently, the app is only available via a closed beta. It will be on the App Store within the next few weeks.
+</p>
+
+<p class='img'>
+  <img src='/images/ios/control1.png' width='310' height='552' />
+  An example of a Home Assistant group as seen in the iOS app.
+</p>
+
+## Basic requirements
+
+* iOS device running at least iOS 9, but iOS 10 is greatly preferred.
+* Home Assistant 0.31.1 or higher for push notification support.
+* SSL is strongly recommended. Self-signed SSL certificates will not work due to Apple's limitations.
+
+The `ios` component is the companion component for the Home Assistant iOS app. While not required, adding the `ios` component to your setup will greatly enhance the iOS app with new notification, location and sensor functions not possible with a standalone app.
+
+Loading the `ios` component will also load the [`device_tracker`][device-tracker], [`zeroconf`][zeroconf] and [`notify`][notify] platforms.
+
+## {% linkable_title Setup %}
+
+### Automated Setup
+
+The `ios` component will automatically be loaded under the following circumstances:
+
+1. The [`discovery`][discovery] component is enabled.
+2. You have just installed the app and are at the getting started screen.
+
+Automated discovery and component loaded can only happen at first install of the app. You may need to wait a few minutes for the iOS component to load as the `discovery` component only scans the network every 5 minutes.
+
+### Manual Setup
+
+You may also manually load the `ios` component by adding the following to your configuration:
+
+```yaml
+# Example configuration.yaml entry
+ios:
+```
+
+Configuration variables:
+
+- **push** (*Optional*): Push notification configuration. See the [iOS `notify` platform][ios-notify] for more information.
+
+[discovery]: /components/discovery
+[device-tracker]: /components/device_tracker
+[zeroconf]: /components/zeroconf
+[notify]: /components/notify
+[ios-notify]: /ecosystem/ios/notifications/