diff --git a/source/_components/tellduslive.markdown b/source/_components/tellduslive.markdown
index 9effddbb502..bf571f33590 100644
--- a/source/_components/tellduslive.markdown
+++ b/source/_components/tellduslive.markdown
@@ -12,19 +12,33 @@ ha_category: Hub
 featured: false
 ---
 
-[Telldus Live] is a cloud platform that connects to your Tellstick connected gear at home.
+The `tellduslive` component let you connect to [Telldus Live](https://live.telldus.com). It's cloud platform that connects to your Tellstick connected gear at home.
 
-[Telldus Live]: https://live.telldus.com
+To get started using Telldus Live, you will have to obtain developer keys from (https://api.telldus.com/keys/index)[developer-keys].
 
-To get started using Telldus Live, you will have to obtain developer keys from [here][developer-keys].
-
-[developer-keys]: https://api.telldus.com/keys/index
+To integrate your Telldus Live with Home Assistant, add the following section to your `configuration.yaml` file:
 
 ```yaml
 # Example configuration.yaml entry
 tellduslive:
-  public_key: XX
-  private_key: XX
-  token: XX
-  token_secret: XX
+  public_key: ABCDEFGHJKLMNOPQRSTUVXYZ
+  private_key: ABCDEFGHJKLMNOPQRSTUVXYZ
+  token: ABCDEFGHJKLMNOPQRSTUVXYZ
+  token_secret: ABCDEFGHJKLMNOPQRSTUVXYZ
 ```
+
+Configuration variables:
+
+- **public_key** (*Required*): The public key for the Telldus Live service.
+- **private_key** (*Required*): The private key for the Telldus Live service.
+- **token** (*Required*): The token for the Telldus Live service.
+- **token_secret** (*Required*): The token secret for the Telldus Live service.
+
+Tellstick Net devices can be auto discovered using [this method](https://developer.telldus.com/doxygen/html/TellStickNet.html).
+
+It might be possible to communicate with the Tellstick Net device directly, bypassing the Tellstick Live service. This however is [poorly documented](http://developer.telldus.se/ticket/114) and yet not [fully supported](https://developer.telldus.com/doxygen/html/TellStickNet.html).
+
+<p class='note warning'>
+API requests to certain methods are limited to one request every 10 minutes.
+</p>
+