chore: improved documentation rules data

Author: andrepimpao

docs/03-rules-all.md

@@ -2,13 +2,25 @@
 
 Validates every element of an `array` with a given set of rules.
 
+```php
+/**
+ * @var RuleInterface[] $constraints
+ */
+All(
+    array $constraints,
+    string $message = 'At "{{ key }}": {{ message }}'
+);
+```
+
 ## Basic Usage
 
 ```php
-Validator::all([Validator::greatarThan(1), Validator::lessThan(10)])->validate([4, 5, 6]); // true
-Validator::all([Validator::greaterThan(1)->lessThan(10)])->validate([4, 5, 6]); // true
+// One rule per array element
+Validator::all([Validator::notBlank(), Validator::greaterThan(1), Validator::lessThan(10)])->validate([4, 5, 6]); // true
+Validator::all([Validator::notBlank(), Validator::greaterThan(1), Validator::lessThan(10)])->validate([4, 5, 20]); // false
 
-Validator::all([Validator::greatarThan(1), Validator::lessThan(10)])->validate([4, 5, 20]); // false
+// Multiple rules per array element
+Validator::all([Validator::notBlank()->greaterThan(1)->lessThan(10)])->validate([4, 5, 6]); // true
 ```
 
 > **Note**
@@ -31,7 +43,6 @@ Each element must implement a `RuleInterface`, so it is possible to use a single
 type: `string` default: `At "{{ key }}": {{ message }}`
 
 Message that will be shown if at least one element of an array is invalid according to the given `constraints`.
-Check the [Custom Messages]() section for more information.
 
 ```php
 Validator::all([Validator::notBlank()])->assert([1, 2, ''], 'Test'); 

docs/03-rules-greater-than-or-equal.md

@@ -3,15 +3,25 @@
 Validates that a value is greater than or equal to another value. 
 Can compare between strings, numbers and dates.
 
+```php
+GreaterThanOrEqual(
+    mixed $constraint,
+    string $message = 'The "{{ name }}" value should be greater than or equal to "{{ constraint }}", "{{ value }}" given.'
+);
+```
+
 ## Basic Usage
 
 ```php
 Validator::greaterThanOrEqual(10)->validate(20); // true
 Validator::greaterThanOrEqual(10)->validate(10); // true
+
 Validator::greaterThanOrEqual(1.5)->validate(2.5); // true
 Validator::greaterThanOrEqual(1.5)->validate(1.5); // true
+
 Validator::greaterThanOrEqual('alpha')->validate('beta'); // true
 Validator::greaterThanOrEqual('alpha')->validate('alpha'); // true
+
 Validator::greaterThanOrEqual(new DateTime('today'))->validate(new DateTime('tomorrow')); // true
 Validator::greaterThanOrEqual(new DateTime('today'))->validate(new DateTime('today')); // true
 ```
@@ -36,8 +46,7 @@ Can be a `string`, `int`, `float` or `DateTimeInterface` object.
 
 type: `string` default: `The "{{ name }}" value should be greater than or equal to "{{ constraint }}", "{{ value }}" given.`
 
-Message that will be shown if the value is not greater than or equal to the constraint value. 
-Check the [Custom Messages]() section for more information.
+Message that will be shown if the value is not greater than or equal to the constraint value.
 
 The following parameters are available:
 

docs/03-rules-greater-than.md

@@ -3,13 +3,27 @@
 Validates that a value is greater than another value. 
 Can compare between strings, numbers and dates.
 
+```php
+GreaterThan(
+    mixed $constraint,
+    string $message = 'The "{{ name }}" value should be greater than "{{ constraint }}", "{{ value }}" given.'
+);
+```
+
 ## Basic Usage
 
 ```php
 Validator::greaterThan(10)->validate(20); // true
+Validator::greaterThan(10)->validate(10); // false
+
 Validator::greaterThan(1.5)->validate(2.5); // true
+Validator::greaterThan(1.5)->validate(1.5); // false
+
 Validator::greaterThan('alpha')->validate('beta'); // true
+Validator::greaterThan('alpha')->validate('alpha'); // false
+
 Validator::greaterThan(new DateTime('today'))->validate(new DateTime('tomorrow')); // true
+Validator::greaterThan(new DateTime('today'))->validate(new DateTime('today')); // false
 ```
 
 > **Note**
@@ -32,8 +46,7 @@ Can be a `string`, `int`, `float` or `DateTimeInterface` object.
 
 type: `string` default: `The "{{ name }}" value should be greater than "{{ constraint }}", "{{ value }}" given.`
 
-Message that will be shown if the value is not greater than the constraint value. 
-Check the [Custom Messages]() section for more information.
+Message that will be shown if the value is not greater than the constraint value.
 
 The following parameters are available:
 

docs/03-rules-less-than-or-equal.md

@@ -3,15 +3,25 @@
 Validates that a value is less than or equal to another value. 
 Can compare between strings, numbers and dates.
 
+```php
+LessThanOrEqual(
+    mixed $constraint,
+    string $message = 'The "{{ name }}" value should be less than or equal to "{{ constraint }}", "{{ value }}" given.'
+);
+```
+
 ## Basic Usage
 
 ```php
 Validator::lessThanOrEqual(20)->validate(10); // true
 Validator::lessThanOrEqual(10)->validate(10); // true
+
 Validator::lessThanOrEqual(2.5)->validate(1.5); // true
 Validator::lessThanOrEqual(1.5)->validate(1.5); // true
+
 Validator::lessThanOrEqual('beta')->validate('alpha'); // true
 Validator::lessThanOrEqual('alpha')->validate('alpha'); // true
+
 Validator::lessThanOrEqual(new DateTime('today'))->validate(new DateTime('yesterday')); // true
 Validator::lessThanOrEqual(new DateTime('today'))->validate(new DateTime('today')); // true
 ```
@@ -37,7 +47,6 @@ Can be a `string`, `int`, `float` or `DateTimeInterface` object.
 type: `string` default: `The "{{ name }}" value should be less than or equal to "{{ constraint }}", "{{ value }}" given.`
 
 Message that will be shown if the value is not less than or equal to the constraint value.
-Check the [Custom Messages]() section for more information.
 
 The following parameters are available:
 

docs/03-rules-less-than.md

@@ -3,13 +3,27 @@
 Validates that a value is less than another value. 
 Can compare between strings, numbers and dates.
 
+```php
+LessThan(
+    mixed $constraint,
+    string $message = 'The "{{ name }}" value should be less than "{{ constraint }}", "{{ value }}" given.'
+);
+```
+
 ## Basic Usage
 
 ```php
 Validator::lessThan(20)->validate(10); // true
+Validator::lessThan(20)->validate(20); // false
+
 Validator::lessThan(2.5)->validate(1.5); // true
+Validator::lessThan(2.5)->validate(2.5); // false
+
 Validator::lessThan('beta')->validate('alpha'); // true
+Validator::lessThan('beta')->validate('beta'); // false
+
 Validator::lessThan(new DateTime('today'))->validate(new DateTime('yesterday')); // true
+Validator::lessThan(new DateTime('today'))->validate(new DateTime('today')); // false
 ```
 
 > **Note**
@@ -33,7 +47,6 @@ Can be a `string`, `int`, `float` or `DateTimeInterface` object.
 type: `string` default: `The "{{ name }}" value should be less than "{{ constraint }}", "{{ value }}" given.`
 
 Message that will be shown if the value is not less than the constraint value.
-Check the [Custom Messages]() section for more information.
 
 The following parameters are available:
 

docs/03-rules-not-blank.md

@@ -2,6 +2,13 @@
 
 Validates that a value is not equal to a blank string, blank array, `false` or `null`.
 
+```php
+NotBlank(
+    ?callable $normalizer = null,
+    string $message = 'The "{{ name }}" value should not be blank, "{{ value }}" given.'
+);
+```
+
 ## Basic Usage
 
 Bellow are the only cases where the rule will fail, everything else is considered valid 
@@ -36,8 +43,7 @@ Validator::notBlank(normalizer: fn($value) => trim($value))->validate(' '); // f
 
 type: `string` default: `The "{{ name }}" value should not be blank, "{{ value }}" given.`
 
-Message that will be shown if the value is blank. 
-Check the [Custom Messages]() section for more information.
+Message that will be shown if the value is blank.
 
 The following parameters are available:
 

docs/03-rules-range.md

@@ -3,6 +3,14 @@
 Validates that a value is between a minimum and maximum value.
 Can compare between strings, numbers and dates.
 
+```php
+Range(
+    mixed $minConstraint,
+    mixed $maxConstraint,
+    string $message = 'The "{{ name }}" value should be between "{{ minConstraint }}" and "{{ maxConstraint }}", "{{ value }}" given.'
+);
+```
+
 ## Basic Usage
 
 Values equal to the defined minimum and maximum constraints are considered valid.