From c9fd1be3251a69e061d01d6e0da936a2066c6438 Mon Sep 17 00:00:00 2001
From: Sam Reed <sam@reedyboy.net>
Date: Tue, 10 Oct 2023 07:31:59 +0100
Subject: [PATCH] random.markdown: Add an examples section (#29281)

Co-authored-by: Franck Nijhof <frenck@frenck.nl>
---
 source/_integrations/random.markdown | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/source/_integrations/random.markdown b/source/_integrations/random.markdown
index 02932f638b7..77a208510d6 100644
--- a/source/_integrations/random.markdown
+++ b/source/_integrations/random.markdown
@@ -76,3 +76,18 @@ unit_of_measurement:
   required: false
   type: string
 {% endconfiguration %}
+
+### Examples
+
+In this section you find am example of how this sensor can be used.
+
+Create a random sensor called "My random sensor" which will return a number between 10 (minimum) and 500 (maximum).
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  - platform: random
+    name: "My random sensor"
+    minimum: 10
+    maximum: 500
+```