Reformat documentation files

There was some inconsistent Markdown, and some links were out of sync.

Author: henriquemoody

bin/update-doc-links

@@ -49,10 +49,10 @@ create_rule_documentation()
   sed -nE '/^# /,/^## Changelog/p' "${filename}" | ggrep -E -v '^## Changelog'
 
   # "Changelog" section
-  sed -nE '/^## Changelog/,/^\*\*\*/p' "${filename}" | ggrep -Fv '***'
+  sed -nE '/^## Changelog/,/^---/p' "${filename}"
 
   # "See also" section
-  echo "***"
+  echo
   echo "See also:"
   echo
   echo "${related_links}"

docs/02-feature-guide.md

@@ -4,7 +4,6 @@ The `Validator` class is the core of Respect\Validation, offering a fluent inter
 
 For convenience, the `Validator` class is aliased as `v`. This means you can write `v::intType()` instead of `\Respect\Validation\Validator::intType()`.
 
-
 ## Validating using booleans
 
 With the `isValid()` method, determine if your input meets a specific validation rule.

docs/04-message-translation.md

@@ -4,7 +4,7 @@ We use dependency injection container to create Validators with all their depend
 
 You can use different translators to translate validation messages into different languages, by overwriting the default container in `ContainerRegistry`, passing the translator you desire.
 
-Luckily, the `ContainerRegistry` has method that creates a pre-configured container using [php-di/php-di](https://php-di.org/). That means you just need to overwrite that service. 
+Luckily, the `ContainerRegistry` has method that creates a pre-configured container using [php-di/php-di](https://php-di.org/). That means you just need to overwrite that service.
 
 ```php
 use Respect\Validation\ContainerRegistry;

docs/08-comparable-values.md

@@ -10,8 +10,8 @@ You can make comparison with the following data types:
 - Numeric types
 - Single character string
 - Primitive types in general: normal operation comparison made by PHP
-- Time string: [date and time format](http://php.net/datetime.formats) 
-that can be parsed by PHP
+- Time string: [date and time format](http://php.net/datetime.formats)
+  that can be parsed by PHP
 
 Below you can see some examples:
 

docs/09-list-of-rules-by-category.md

@@ -101,13 +101,6 @@
 - [Uploaded](rules/Uploaded.md)
 - [Writable](rules/Writable.md)
 
-## ISO codes
-
-- [CountryCode](rules/CountryCode.md)
-- [CurrencyCode](rules/CurrencyCode.md)
-- [LanguageCode](rules/LanguageCode.md)
-- [SubdivisionCode](rules/SubdivisionCode.md)
-
 ## Identifications
 
 - [Bsn](rules/Bsn.md)
@@ -137,6 +130,13 @@
 - [Url](rules/Url.md)
 - [VideoUrl](rules/VideoUrl.md)
 
+## ISO codes
+
+- [CountryCode](rules/CountryCode.md)
+- [CurrencyCode](rules/CurrencyCode.md)
+- [LanguageCode](rules/LanguageCode.md)
+- [SubdivisionCode](rules/SubdivisionCode.md)
+
 ## Localization
 
 - [CountryCode](rules/CountryCode.md)
@@ -235,8 +235,8 @@
 - [In](rules/In.md)
 - [Json](rules/Json.md)
 - [Lowercase](rules/Lowercase.md)
-- [NoWhitespace](rules/NoWhitespace.md)
 - [NotEmoji](rules/NotEmoji.md)
+- [NoWhitespace](rules/NoWhitespace.md)
 - [Phone](rules/Phone.md)
 - [PhpLabel](rules/PhpLabel.md)
 - [PostalCode](rules/PostalCode.md)
@@ -401,13 +401,13 @@
 - [Nif](rules/Nif.md)
 - [Nip](rules/Nip.md)
 - [No](rules/No.md)
-- [NoWhitespace](rules/NoWhitespace.md)
 - [NoneOf](rules/NoneOf.md)
 - [Not](rules/Not.md)
 - [NotBlank](rules/NotBlank.md)
 - [NotEmoji](rules/NotEmoji.md)
 - [NotEmpty](rules/NotEmpty.md)
 - [NotUndef](rules/NotUndef.md)
+- [NoWhitespace](rules/NoWhitespace.md)
 - [NullOr](rules/NullOr.md)
 - [NullType](rules/NullType.md)
 - [Number](rules/Number.md)

docs/rules/Alnum.md

@@ -71,8 +71,8 @@ See also:
 - [Decimal](Decimal.md)
 - [Digit](Digit.md)
 - [Lowercase](Lowercase.md)
-- [NoWhitespace](NoWhitespace.md)
 - [NotEmoji](NotEmoji.md)
+- [NoWhitespace](NoWhitespace.md)
 - [Regex](Regex.md)
 - [StringType](StringType.md)
 - [StringVal](StringVal.md)

docs/rules/Alpha.md

@@ -65,8 +65,8 @@ See also:
 - [Decimal](Decimal.md)
 - [Digit](Digit.md)
 - [Lowercase](Lowercase.md)
-- [NoWhitespace](NoWhitespace.md)
 - [NotEmoji](NotEmoji.md)
+- [NoWhitespace](NoWhitespace.md)
 - [Regex](Regex.md)
 - [Uppercase](Uppercase.md)
 - [Vowel](Vowel.md)

docs/rules/AlwaysValid.md

@@ -38,3 +38,5 @@ v::alwaysValid()->isValid('whatever'); // true
 See also:
 
 - [AlwaysInvalid](AlwaysInvalid.md)
+- [KeyExists](KeyExists.md)
+- [PropertyExists](PropertyExists.md)

docs/rules/Attributes.md

@@ -70,9 +70,9 @@ v::attributes()->assert(new Person('', 'not a date', 'not an email', 'not a phon
 
 ## Caveats
 
-* If the object has no attributes, the validation will always pass.
-* When the property is nullable, this rule will wrap the rule on the property into [NullOr](NullOr.md) rule.
-* This rule has no templates because it uses the templates of the rules that are applied to the properties.
+- If the object has no attributes, the validation will always pass.
+- When the property is nullable, this rule will wrap the rule on the property into [NullOr](NullOr.md) rule.
+- This rule has no templates because it uses the templates of the rules that are applied to the properties.
 
 ## Categorization
 
@@ -82,10 +82,11 @@ v::attributes()->assert(new Person('', 'not a date', 'not an email', 'not a phon
 ## Changelog
 
 | Version | Description |
-|--------:|-------------|
+| ------: | ----------- |
 |   3.0.0 | Created     |
 
-***
+---
+
 See also:
 
 - [Named](Named.md)

docs/rules/Call.md

@@ -46,17 +46,17 @@ v::call(
 ### `Call::TEMPLATE_STANDARD`
 
 | Mode       | Template                                                   |
-|------------|------------------------------------------------------------|
+| ---------- | ---------------------------------------------------------- |
 | `default`  | {{input}} must be a suitable argument for {{callable}}     |
 | `inverted` | {{input}} must not be a suitable argument for {{callable}} |
 
 ## Template placeholders
 
 | Placeholder | Description                                                      |
-|-------------|------------------------------------------------------------------|
+| ----------- | ---------------------------------------------------------------- |
 | `callable`  |                                                                  |
 | `input`     |                                                                  |
-| `subject`      | The validated input or the custom validator name (if specified). |
+| `subject`   | The validated input or the custom validator name (if specified). |
 
 ## Categorization
 
@@ -67,10 +67,11 @@ v::call(
 ## Changelog
 
 | Version | Description |
-|--------:|-------------|
+| ------: | ----------- |
 |   0.3.9 | Created     |
 
-***
+---
+
 See also:
 
 - [Callback](Callback.md)