Site updated at 2017-08-26 11:19:36 UTC

components/discovery/index.html

@@ -74,7 +74,7 @@
     </h1>
   </header>
   <hr class="divider">
-  <p>Home Assistant can discover and automatically configure zeroconf/mDNS and uPnP devices on your network. Currently the <code class="highlighter-rouge">discovery</code> component can detect:</p>
+  <p>Home Assistant can discover and automatically configure <a href="https://en.wikipedia.org/wiki/Zero-configuration_networking">zeroconf</a>/<a href="https://en.wikipedia.org/wiki/Multicast_DNS">mDNS</a> and <a href="https://en.wikipedia.org/wiki/Universal_Plug_and_Play">uPnP</a> devices on your network. Currently the <code class="highlighter-rouge">discovery</code> component can detect:</p>
 <ul>
   <li>Google Chromecast</li>
   <li>Belkin WeMo switches</li>
@@ -113,7 +113,7 @@
 <p>Valid values for ignore are:</p>
 <ul>
   <li><code class="highlighter-rouge">apple_tv</code>: Apple TV</li>
-  <li><code class="highlighter-rouge">axis</code>: (Axis Communications security devices)</li>
+  <li><code class="highlighter-rouge">axis</code>: Axis Communications security devices</li>
   <li><code class="highlighter-rouge">bose_soundtouch</code>: Bose Soundtouch speakers</li>
   <li><code class="highlighter-rouge">denonavr</code>: Denon Network Receivers</li>
   <li><code class="highlighter-rouge">directv</code>: DirecTV</li>
@@ -121,30 +121,30 @@
   <li><code class="highlighter-rouge">google_cast</code>: Google Chromecast</li>
   <li><code class="highlighter-rouge">ikea_tradfri</code>: IKEA Trådfri</li>
   <li><code class="highlighter-rouge">logitech_mediaserver</code>: Logitech media server - Squeezebox player</li>
-  <li><code class="highlighter-rouge">openhome</code>: Linn / Openhome</li>
+  <li><code class="highlighter-rouge">openhome</code>: Linn/Openhome</li>
   <li><code class="highlighter-rouge">panasonic_viera</code>: Panasonic Viera</li>
   <li><code class="highlighter-rouge">philips_hue</code>: Philips Hue</li>
   <li><code class="highlighter-rouge">plex_mediaserver</code>: Plex media server</li>
   <li><code class="highlighter-rouge">roku</code>: Roku media player</li>
-  <li><code class="highlighter-rouge">samsung_tv</code>: (Samsung TV</li>
+  <li><code class="highlighter-rouge">samsung_tv</code>: Samsung TV</li>
   <li><code class="highlighter-rouge">sonos</code>: Sonos Speakers</li>
   <li><code class="highlighter-rouge">yamaha</code>: Yamaha media player</li>
   <li><code class="highlighter-rouge">yeelight</code>: Yeelight Sunflower Bulb</li>
 </ul>
 <p class="note">
 Home Assistant must be on the same network as the devices for uPnP discovery to work.
-If running Home Assistant in a Docker container use switch <code class="highlighter-rouge">--net=host</code> to put it on the host’s network.
+If running Home Assistant in a <a href="/docs/installation/docker/">Docker container</a> use switch <code class="highlighter-rouge">--net=host</code> to put it on the host’s network.
 </p>
-<p>If you are developing a new platform, please read <a href="/developers/add_new_platform/#discovery">how to make your platform discoverable</a>.</p>
 <p class="note warning">
-There is currently a <a href="https://bitbucket.org/al45tair/netifaces/issues/17/dll-fails-to-load-windows-81-64bit">known issue</a> with running this platform on a 64-bit version of Python and Windows.
+There is currently a <a href="https://bitbucket.org/al45tair/netifaces/issues/17/dll-fails-to-load-windows-81-64bit">known issue</a> with running this component on a 64-bit version of Python and Windows.
 </p>
 <p class="note">
-If you are on Windows and you’re using Python 3.5, download the Netifaces dependency <a href="http://www.lfd.uci.edu/~gohlke/pythonlibs/#netifaces">here</a>.
+If you are on Windows and you’re using Python 3.5, download the <a href="http://www.lfd.uci.edu/~gohlke/pythonlibs/#netifaces">Netifaces</a> dependency.
 </p>
 <p class="note">
 If you see <code class="highlighter-rouge">Not initializing discovery because could not install dependency netdisco==0.6.1</code> in the logs, you will need to install the <code class="highlighter-rouge">python3-dev</code> or <code class="highlighter-rouge">python3-devel</code> package on your system manually (eg. <code class="highlighter-rouge">sudo apt-get install python3-dev</code> or <code class="highlighter-rouge">sudo dnf -y install python3-devel</code>). On the next restart of home-assistant, discovery should work. If you still get an error, check if you have a compiler (<code class="highlighter-rouge">gcc</code>) available on your system.
 </p>
+<p>If you are developing a new platform, please read <a href="/developers/component_discovery/">how to make your platform discoverable</a> for further details.</p>
 </article>
         </div>
         <aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole">

components/xiaomi/index.html

@@ -178,7 +178,7 @@
 </code></pre>
 </div>
 <h3><a class="title-link" name="retrieving-access-token" href="#retrieving-access-token"></a> Retrieving Access Token</h3>
-<p>Follow the pairing process using your phone and Mi-Home app. From here you will be able to retrieve the token from a SQLite file inside your phone.</p>
+<p>Follow the pairing process using your phone and Mi-Home app. You will be able to retrieve the token from a SQLite file inside your phone. This token is needed for using various <code class="highlighter-rouge">xiaomi</code> platforms.</p>
 <p>Before you begin you need to install <code class="highlighter-rouge">libffi-dev</code> by running the command below. This is needed for <code class="highlighter-rouge">python-mirobi</code> to be installed correctly.</p>
 <div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo apt-get install libffi-dev
 </code></pre>