From 9f08d18f96e231cd55b36cd4560a216a06724302 Mon Sep 17 00:00:00 2001
From: Qiang Xue <qiang.xue@gmail.com>
Date: Thu, 26 Jun 2014 22:50:57 -0400
Subject: [PATCH] Fixes #3020 [skip ci]

---
 framework/validators/Validator.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/framework/validators/Validator.php b/framework/validators/Validator.php
index 8b881c7d6b..a351e7753b 100644
--- a/framework/validators/Validator.php
+++ b/framework/validators/Validator.php
@@ -93,6 +93,11 @@ class Validator extends Component
      *
      * - `{attribute}`: the label of the attribute being validated
      * - `{value}`: the value of the attribute being validated
+     *
+     * Note that some validators may introduce other properties for error messages used when specific
+     * validation conditions are not met. Please refer to individual class API documentation for details
+     * about these properties. By convention, this property represents the primary error message
+     * used when the most important validation condition is not met.
      */
     public $message;
     /**