Various updates

source/_components/configurator.markdown

@@ -14,8 +14,12 @@ ha_category: Other
 This component is intended for developers.
 </p>
 
-The configurator component allows components to request information from the user. It is currently implemented as the minimum viable product: it supports showing a text, image and button to the user. It will trigger a callback when the button is pressed.
+The configurator component allows components to request information from the user. It is currently implemented as the minimum viable product:
 
-The Hue component in [the demo](/demo) is implemented using the configurator. See [the source of the demo component](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/demo.py#L72) for a simple example.
+- It supports showing a text, image and button to the user
+- Input fields can be defined with a description, and optional type
+- It will trigger a callback when the button is pressed
+
+The Hue component in [the demo](/demo) and Plex are implemented using the configurator. See [the source of the demo component](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/demo.py#L72) for a simple example.
 
 See [the source](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/configurator.py#L39) for more details on how to use the configurator component.

source/_components/discovery.markdown

@@ -17,6 +17,7 @@ Home Assistant can discover and automatically configure zeroconf/mDNS and uPnP d
  * Belkin WeMo switches
  * Philips Hue
  * Netgear routers
+ * Plex Media Server
 
 It will be able to add Google Chreomcasts and Belkin WeMo switches automatically, for Philips Hue it will require some configuration from the user.
 

source/_components/downloader.markdown

@@ -20,6 +20,7 @@ To enable it, add the following lines to your `configuration.yaml`:
 downloader:
   download_dir: downloads
 ```
+If the path is not absolute, it's assumed to be relative to the HASS configuration directory.
 
 #### Service `downloader/download_file`
 

source/_components/media_player.plex.markdown

@@ -14,20 +14,23 @@ featured: true
 
 
 The Plex platform allows you to connect a [Plex Media Server](https://plex.tv) to Home Assistant. It will allow you to control media playback and see the current playing item.
+The preferred way to setup the Plex platform is by enabling the the [the discovery component]({{site_root}}/components/discovery.html) and requires GDM to be enabled.
 
-To add Plex to your installation, add the following to your `configuration.yaml` file:
+If local authentication is enabled or multiple users are defined, HASS requires an authentication token to be entered in the webinterface. See <A TARGET="_new" HREF=https://support.plex.tv/hc/en-us/articles/204059436>Finding your account token / X-Plex-Token</A>.
 
+
+If you want to enable the plex platform directly, add the following lines to your `configuration.yaml`:
 ```yaml
 # Example configuration.yaml entry
 media_player:
-  platform: plex
+  - platform: plex
-  name: plex_server
-  user: YOUR_USERNAME
-  password: YOUR_PASSWORD
 ```
+You may also need to create the file `plex.conf`. 
+```
+{'IP_ADDRESS:PORT': {'token': 'TOKEN'}}
+```
+- **IP_ADDRESS** *Required*: IP address of the Plex Media Server
+- **PORT** *required*: Default is 32400
+- **TOKEN** *Optional*: Only is authentication is required. Set to `None` (without quotes) otherwise.
 
-Configuration variables:
+At this moment, the Plex platform only supports one Plex Media Server.
-
-- **name** *Required*: The name of the backend device (Under Plex Media Server > settings > server)
-- **user** *Required*: The username for your Pley server.
-- **password** *Required*: The password for your Plex server.

source/getting-started/devices.markdown

@@ -44,6 +44,8 @@ By default, all of your devices will be visible and have a default icon determin
 You may find it desireable to customize the look and feel of your front page by altering some
 of these parameters. This can be done by adding the following config to the `homeassistant:` section.
 
+Entity_pictures, badges, device_tracker pictures, etc can either be a URL or `/local/file.jpg`, which points to directory `www` in the HASS configuration directory.
+
 ```yaml
 # Example configuration.yaml entry
 homeassistant: