From ae0ea6988be0e40e97c6e95c9b914d037d03efdf Mon Sep 17 00:00:00 2001
From: Mark Green <mark.green@digital.cabinet-office.gov.uk>
Date: Tue, 25 Feb 2020 13:49:42 +0000
Subject: [PATCH] Clarify what falsy errorMessage values do

---
 src/govuk/components/character-count/character-count.yaml | 2 +-
 src/govuk/components/checkboxes/checkboxes.yaml           | 2 +-
 src/govuk/components/date-input/date-input.yaml           | 2 +-
 src/govuk/components/file-upload/file-upload.yaml         | 2 +-
 src/govuk/components/input/input.yaml                     | 2 +-
 src/govuk/components/radios/radios.yaml                   | 2 +-
 src/govuk/components/select/select.yaml                   | 2 +-
 src/govuk/components/textarea/textarea.yaml               | 2 +-
 8 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/govuk/components/character-count/character-count.yaml b/src/govuk/components/character-count/character-count.yaml
index 01e3538c44..f84d65f6b4 100644
--- a/src/govuk/components/character-count/character-count.yaml
+++ b/src/govuk/components/character-count/character-count.yaml
@@ -40,7 +40,7 @@ params:
 - name: errorMessage
   type: object
   required: false
-  description: Options for the errorMessage component (e.g. text).
+  description: Options for the error message component. The error message component will not display if you use a falsy value for `errorMessage`, for example `false` or `null`.
   isComponent: true
 - name: formGroup
   type: object
diff --git a/src/govuk/components/checkboxes/checkboxes.yaml b/src/govuk/components/checkboxes/checkboxes.yaml
index dd3bfe3b99..1468078f96 100644
--- a/src/govuk/components/checkboxes/checkboxes.yaml
+++ b/src/govuk/components/checkboxes/checkboxes.yaml
@@ -16,7 +16,7 @@ params:
 - name: errorMessage
   type: object
   required: false
-  description: Options for the errorMessage component (e.g. text).
+  description: Options for the error message component. The error message component will not display if you use a falsy value for `errorMessage`, for example `false` or `null`.
   isComponent: true
 - name: formGroup
   type: object
diff --git a/src/govuk/components/date-input/date-input.yaml b/src/govuk/components/date-input/date-input.yaml
index 5e7e2f6c4f..f1c531027b 100644
--- a/src/govuk/components/date-input/date-input.yaml
+++ b/src/govuk/components/date-input/date-input.yaml
@@ -52,7 +52,7 @@ params:
 - name: errorMessage
   type: object
   required: false
-  description: Options for the error message.
+  description: Options for the error message component. The error message component will not display if you use a falsy value for `errorMessage`, for example `false` or `null`.
   isComponent: true
 - name: formGroup
   type: object
diff --git a/src/govuk/components/file-upload/file-upload.yaml b/src/govuk/components/file-upload/file-upload.yaml
index 713db75d34..df6be49c40 100644
--- a/src/govuk/components/file-upload/file-upload.yaml
+++ b/src/govuk/components/file-upload/file-upload.yaml
@@ -28,7 +28,7 @@ params:
 - name: errorMessage
   type: object
   required: false
-  description: Options for the errorMessage component.
+  description: Options for the error message component. The error message component will not display if you use a falsy value for `errorMessage`, for example `false` or `null`.
   isComponent: true
 - name: formGroup
   type: object
diff --git a/src/govuk/components/input/input.yaml b/src/govuk/components/input/input.yaml
index b2b862c3e0..cd2a8a70ad 100644
--- a/src/govuk/components/input/input.yaml
+++ b/src/govuk/components/input/input.yaml
@@ -36,7 +36,7 @@ params:
 - name: errorMessage
   type: object
   required: false
-  description: Options for the errorMessage component.
+  description: Options for the error message component. The error message component will not display if you use a falsy value for `errorMessage`, for example `false` or `null`.
   isComponent: true
 - name: formGroup
   type: object
diff --git a/src/govuk/components/radios/radios.yaml b/src/govuk/components/radios/radios.yaml
index cb20166992..be045216d1 100644
--- a/src/govuk/components/radios/radios.yaml
+++ b/src/govuk/components/radios/radios.yaml
@@ -12,7 +12,7 @@ params:
 - name: errorMessage
   type: object
   required: false
-  description: Options for the errorMessage component (e.g. text).
+  description: Options for the error message component. The error message component will not display if you use a falsy value for `errorMessage`, for example `false` or `null`.
   isComponent: true
 - name: formGroup
   type: object
diff --git a/src/govuk/components/select/select.yaml b/src/govuk/components/select/select.yaml
index d4298a0a02..7d188d7e00 100644
--- a/src/govuk/components/select/select.yaml
+++ b/src/govuk/components/select/select.yaml
@@ -49,7 +49,7 @@ params:
 - name: errorMessage
   type: object
   required: false
-  description: Options for the errorMessage component (e.g. text).
+  description: Options for the error message component. The error message component will not display if you use a falsy value for `errorMessage`, for example `false` or `null`.
   isComponent: true
 - name: formGroup
   type: object
diff --git a/src/govuk/components/textarea/textarea.yaml b/src/govuk/components/textarea/textarea.yaml
index 9e7d9385ac..09c8d6779c 100644
--- a/src/govuk/components/textarea/textarea.yaml
+++ b/src/govuk/components/textarea/textarea.yaml
@@ -32,7 +32,7 @@ params:
 - name: errorMessage
   type: object
   required: false
-  description: Options for the errorMessage component (e.g. text).
+  description: Options for the error message component. The error message component will not display if you use a falsy value for `errorMessage`, for example `false` or `null`.
   isComponent: true
 - name: formGroup
   type: object