From 452f745aad44ba2f88d7fe9095b9452f255b1bb1 Mon Sep 17 00:00:00 2001
From: jfurtner <1195789+jfurtner@users.noreply.github.com>
Date: Wed, 21 Aug 2024 23:41:53 -0600
Subject: [PATCH] Update blueprint schema documentation (#34395)

* Update blueprint schema documentation

min_version documentation doesn't mention required format, make that explicit in doc and in note about sections

* Update source/_docs/blueprint/schema.markdown

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Update source/_docs/blueprint/schema.markdown

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 source/_docs/blueprint/schema.markdown | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/source/_docs/blueprint/schema.markdown b/source/_docs/blueprint/schema.markdown
index bac52d9e98c..efe01e735fa 100644
--- a/source/_docs/blueprint/schema.markdown
+++ b/source/_docs/blueprint/schema.markdown
@@ -72,9 +72,10 @@ homeassistant:
   keys:
     min_version:
       description: >
-        Minimum required version of Home Assistant to use the blueprint. For example,
-        `2022.4.0`. It is important to set this if the blueprint uses any features
-        introduced in recent releases to head off issues.
+        Minimum required version of Home Assistant to use the blueprint in the format of
+        *major*.*minor*.*patch* (all parts are required). For example, `2022.4.0`. It is
+        important to set this if the blueprint uses any features introduced in recent
+        releases to head off issues.
       type: string
       required: false
 input:
@@ -154,7 +155,7 @@ allows an optional description, and optionally allows for collapsing those input
 A section is differentiated from an input by the presence of an additional `input` key within that section. 
 
 {% caution %}
-Input sections are a new feature in version 2024.6. Set the `min_version` for the blueprint to at least this version if using input sections. Otherwise, the blueprint will generate errors on older versions. 
+Input sections are a new feature in version 2024.6.0. Set the `min_version` for the blueprint to at least this version if using input sections. Otherwise, the blueprint will generate errors on older versions.
 {% endcaution %}
 
 The full configuration for a section is below: