fixup: move and edit docs

Author: weierophinney

Diff for: doc/book/validators/undisclosed-password.md renamed to docs/book/validators/undisclosed-password.md

@@ -1,12 +1,14 @@
 # Undisclosed Password Validator
 
+- **Since 2.13.0**
+
 `Zend\Validator\UndisclosedPassword` allows you to validate if a given password was found in data breaches using the service [Have I Been Pwned?](https://www.haveibeenpwned.com), in a secure, anonymous way using [K-Anonymity](https://www.troyhunt.com/ive-just-launched-pwned-passwords-version-2) to ensure passwords are not send in full over the wire.
 
 > ### Installation requirements
 > 
-> This validator needs to make a request over HTTP, therefor it requires an HTTP client of your choice that implements [PSR-18](https://www.php-fig.org/psr/psr-18/) and [PSR-17](https://www.php-fig.org/psr/psr-17/) request and response factories.
+> This validator needs to make a request over HTTP; therefore it requires an HTTP client. The validator provides support only for HTTP clients implementing [PSR-18](https://www.php-fig.org/psr/psr-18/) and [PSR-17](https://www.php-fig.org/psr/psr-17/) request and response factories.
 >
-> Make sure you have it installed before using this validator:
+> To ensure you have these installed before using this validator, run the following:
 >
 > ```bash
 > $ composer require psr/http-client
@@ -15,30 +17,33 @@
 
 ## Basic usage
 
-To validate if a password was disclosed in a known data breach, you need to provide a HTTP Client that implements `Psr\Http\Client\ClientInterface`, a `Psr\Http\Message\RequestFactoryInterface` and a `Psr\Http\Message\ResponseFactoryInterface` to the constructor and validate the password you want to check.
+The validator has three required constructor arguments:
+
+- an HTTP Client that implements `Psr\Http\Client\ClientInterface`
+- a `Psr\Http\Message\RequestFactoryInterface` instance
+- a `Psr\Http\Message\ResponseFactoryInterface` instance
 
-If the password was found via the service, `isValid` will return `false`. If the password was not found, `isValid` will return `true`.
+Once you have an instance, you can then pass a password to its `isValid()` method to determine if it has been disclosed in a known data breach.
+
+If the password was found via the service, `isValid()` will return `false`. If the password was not found, `isValid()` will return `true`.
 
 ```php
 $validator = new Zend\Validator\UndisclosedPassword(
     $httpClient, // a PSR-18 HttpClientInterface
     $requestFactory, // a PSR-17 RequestFactoryInterface
     $responseFactory // a PSR-17 ResponseFactoryInterface
 );
-```
-```php
-$result = $validator->isValid('password'); 
+
+$result = $validator->isValid('password');
 // $result is FALSE because "password" was found in a data breach
-```
 
-```php
 $result = $validator->isValid('8aDk=XiW2E.77tLfuAcB'); 
 // $result is TRUE because "8aDk=XiW2E.77tLfuAcB" was not found in a data breach
 ```
 
 ## A simple command line example
 
-In this example I'm using `zendframework/zend-diactoros` for HTTP messaging and `php-http/curl-client` as the HTTP client. Let's begin with installation of all required packages:
+In this example, I'm using `zendframework/zend-diactoros` to provide HTTP messages, and `php-http/curl-client` as the HTTP client. Let's begin with installation of all required packages:
 
 ```bash
 $ composer require \
@@ -47,10 +52,10 @@ $ composer require \
     php-http/discovery \
     php-http/curl-client \
     zendframework/zend-diactoros \
-    zendframework/zend-validator 
+    zendframework/zend-validator
 ```
 
-Next thing is I create a file `undisclosed.php` where I will put in my code.
+Next, I create a file, `undisclosed.php`, where I put my code:
 
 ```php
 <?php
@@ -74,13 +79,13 @@ echo 'Password "password" is ' . ($undisclosedPassword->isValid('password') ? 'n
 echo 'Password "NVt3MpvQ" is ' . ($undisclosedPassword->isValid('NVt3MpvQ') ? 'not disclosed' : 'disclosed') . PHP_EOL;
 ```
 
-To run it, I use PHP on the command line:
+To run it, I use the PHP command line interpreter:
 
 ```bash
 $ php undisclosed.php
 ```
 
-And it will give me the following output:
+And it gives me the following output:
 
 ```bash
 Password "password" is disclosed

Diff for: mkdocs.yml

@@ -35,6 +35,7 @@ nav:
             - Step: validators/step.md
             - StringLength: validators/string-length.md
             - Timezone: validators/timezone.md
+            - UndisclosedPassword: validators/undisclosed-password.md
             - Uri: validators/uri.md
             - Uuid: validators/uuid.md
         - "File Validators":