From 6abca15d98fd54901ed4917ce4a140bd12cf2de7 Mon Sep 17 00:00:00 2001
From: Thibault Maekelbergh <thibault.maekelbergh@iCloud.com>
Date: Mon, 18 Dec 2017 19:11:04 +0100
Subject: [PATCH] Add documentation for Discogs sensor (#4138)

* Add documentation for Discogs sensor

* Update config style
---
 source/_components/sensor.discogs.markdown | 39 ++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 source/_components/sensor.discogs.markdown

diff --git a/source/_components/sensor.discogs.markdown b/source/_components/sensor.discogs.markdown
new file mode 100644
index 00000000000..4c4bfe4ef65
--- /dev/null
+++ b/source/_components/sensor.discogs.markdown
@@ -0,0 +1,39 @@
+---
+layout: page
+title: Discogs Sensor
+description: "Instructions on how to set up Discogs sensors within Home Assistant."
+date: 2017-12-04 22:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: https://www.magneticmag.com/.image/t_share/MTQ5OTE1NzU4NTczMzk3OTYw/discogs-vinyl-record-mark.png
+ha_category: Sensor
+ha_release: 0.61
+ha_iot_class: "Cloud Polling"
+---
+
+The `discogs` platform allows you to see the current amount of records in your [Discogs](https://discogs.com) collection.
+
+First, you'll need to get a personal access token from your Discogs account.
+You can generate a token from your profile's [Developer settings](https://www.discogs.com/settings/developers).
+
+To enable this sensor, add the following lines to your `configuration.yaml`:
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  - platform: discogs
+    token: YOUR_TOKEN
+```
+
+{% configuration %}
+token:
+  description: The Discogs API token to use as identification to get your collection.
+  required: true
+  type: string
+name:
+  description: Name to use in the frontend.
+  required: false
+  type: string
+{% endconfiguration %}