diff --git a/docs/book/index.html b/docs/book/index.html
deleted file mode 100644
index 35edad9b..00000000
--- a/docs/book/index.html
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
zend-diactoros
-
-
PSR-7 HTTP message implementation.
-
-
$ composer require zendframework/zend-diactoros
-
-
-
diff --git a/docs/book/v1/api.md b/docs/book/v1/api.md
index 8705ee8c..c016ae90 100644
--- a/docs/book/v1/api.md
+++ b/docs/book/v1/api.md
@@ -75,7 +75,7 @@ Like the `Request` and `ServerRequest`, responses are immutable. Any methods tha
### HtmlResponse and JsonResponse
-- Added in 1.1.0
+> Available since version 1.1.0
The most common use case in server-side applications for generating responses is to provide a string
to use for the response, typically HTML or data to serialize as JSON. `Zend\Diactoros\Response\HtmlResponse` and `Zend\Diactoros\Response\JsonResponse` exist to facilitate these use cases:
@@ -128,9 +128,9 @@ $request = RequestFactory::fromGlobals(
);
```
-### ServerRequestFactory helper functions
+### ServerRequestFactory Helper Functions
-- Since 1.8.0
+> Available since version 1.8.0
In order to create the various artifacts required by a `ServerRequest` instance,
Diactoros also provides a number of functions under the `Zend\Diactoros`
diff --git a/docs/book/v1/custom-responses.md b/docs/book/v1/custom-responses.md
index d1f4bb19..06eda06e 100644
--- a/docs/book/v1/custom-responses.md
+++ b/docs/book/v1/custom-responses.md
@@ -60,7 +60,7 @@ Headers must be in the same format as you would provide to the
## XML Responses
-- Since 1.7.0
+> Available since version 1.7.0
`Zend\Diactoros\Response\XmlResponse` allows specifying XML as a payload, and sets the
`Content-Type` header to `application/xml` by default:
@@ -180,7 +180,7 @@ $uri = $request->getUri();
$response = new RedirectResponse($uri->withPath('/login'));
```
-## Creating custom responses
+## Creating custom Responses
PHP allows constructor overloading. What this means is that constructors of extending classes can
define completely different argument sets without conflicting with the parent implementation.
diff --git a/docs/book/v1/emitting-responses.md b/docs/book/v1/emitting-responses.md
index b682fa4e..c32b68e7 100644
--- a/docs/book/v1/emitting-responses.md
+++ b/docs/book/v1/emitting-responses.md
@@ -1,6 +1,6 @@
-# Emitting responses
+# Emitting Responses
-> ## Deprecated
+> ### Deprecated
>
> Emitters are deprecated from Diactoros starting with version 1.8.0. The
> functionality is now available for any PSR-7 implementation via the package
@@ -29,7 +29,7 @@ $emitter = new Zend\Diactoros\Response\SapiEmitter();
$emitter->emit($response);
```
-## Emitting ranges of streamed files
+## Emitting Ranges of streamed Files
The `SapiStreamEmitter` is useful when you want to emit a `Content-Range`. As an
example, to stream a range of bytes from a file to a client, the client can pass
@@ -53,8 +53,8 @@ $response = new Response($body);
$response = $response->withHeader('Content-Range', $range);
```
-> Note: you will likely want to ensure the range specified falls within the
-> content size of the streamed body!
+(Note: you will likely want to ensure the range specified falls within the
+content size of the streamed body!)
The `SapiStreamEmitter` detects the `Content-Range` header and emits only the
bytes specified.
diff --git a/docs/book/v1/install.md b/docs/book/v1/install.md
index c9033fd6..0dac69ec 100644
--- a/docs/book/v1/install.md
+++ b/docs/book/v1/install.md
@@ -1,4 +1,4 @@
-# Installation and Requirements
+# Installation
Install this library using composer:
diff --git a/docs/book/v1/overview.md b/docs/book/v1/overview.md
index 16dbf99b..bb7f8fe4 100644
--- a/docs/book/v1/overview.md
+++ b/docs/book/v1/overview.md
@@ -1,4 +1,4 @@
-# zend-diactoros: HTTP Messages
+# Overview
`zend-diactoros` is a PHP package containing implementations of the [accepted PSR-7 HTTP message
interfaces](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-7-http-message.md), as
diff --git a/docs/book/v1/serialization.md b/docs/book/v1/serialization.md
index ba22c377..aa3b5576 100644
--- a/docs/book/v1/serialization.md
+++ b/docs/book/v1/serialization.md
@@ -32,7 +32,7 @@ the following static methods:
The deserialization methods (`fromArray()`) will raise exceptions if errors occur while parsing the
message.
-### Example usage
+### Example Usage
Array serialization can be usesful for log messages:
diff --git a/docs/book/v1/usage.md b/docs/book/v1/usage.md
index 80406c2d..aea1d72f 100644
--- a/docs/book/v1/usage.md
+++ b/docs/book/v1/usage.md
@@ -60,7 +60,7 @@ illustration of a possible implementation.)
Server-side applications will need to marshal the incoming request based on superglobals, and will
then populate and send a response.
-### Marshaling an incoming request
+### Marshaling an incoming Request
PHP contains a plethora of information about the incoming request, and keeps that information in a
variety of locations. `Zend\Diactoros\ServerRequestFactory::fromGlobals()` can simplify marshaling
@@ -94,7 +94,7 @@ in the name were renamed with underlines. By getting the cookies directly from t
access to the original cookies in the way you set them in your application and they are send by the user
agent.
-### Manipulating the response
+### Manipulating the Response
Use the response object to add headers and provide content for the response. Writing to the body
does not create a state change in the response, so it can be done without capturing the return
@@ -116,7 +116,7 @@ $response = $response
->withAddedHeader('X-Show-Something', 'something');
```
-### "Serving" an application
+### "Serving" an Application
> ### Deprecated
>
diff --git a/docs/book/v2/api.md b/docs/book/v2/api.md
index d4ff1886..a37cfb46 100644
--- a/docs/book/v2/api.md
+++ b/docs/book/v2/api.md
@@ -126,7 +126,7 @@ $request = RequestFactory::fromGlobals(
);
```
-### ServerRequestFactory helper functions
+### ServerRequestFactory Helper Functions
In order to create the various artifacts required by a `ServerRequest` instance,
Diactoros also provides a number of functions under the `Zend\Diactoros`
diff --git a/docs/book/v2/custom-responses.md b/docs/book/v2/custom-responses.md
index 0fd7d08f..38bf4ef3 100644
--- a/docs/book/v2/custom-responses.md
+++ b/docs/book/v2/custom-responses.md
@@ -210,7 +210,7 @@ $uri = $request->getUri();
$response = new RedirectResponse($uri->withPath('/login'));
```
-## Creating custom responses
+## Creating custom Responses
PHP allows constructor overloading. What this means is that constructors of extending classes can
define completely different argument sets without conflicting with the parent implementation.
diff --git a/docs/book/v2/factories.md b/docs/book/v2/factories.md
index 87fa7eaa..6cc19e70 100644
--- a/docs/book/v2/factories.md
+++ b/docs/book/v2/factories.md
@@ -1,4 +1,4 @@
-# HTTP Message Factories
+# Factories
[PSR-17](https://www.php-fig.org/psr/psr-17/) defines factory interfaces for
creating [PSR-7](https://www.php-fig.org/psr/psr-7/) instances. As of version
diff --git a/docs/book/v2/install.md b/docs/book/v2/install.md
index 0c4a0ec3..d05b3202 100644
--- a/docs/book/v2/install.md
+++ b/docs/book/v2/install.md
@@ -1,4 +1,4 @@
-# Installation and Requirements
+# Installation
Install this library using composer:
diff --git a/docs/book/v2/migration.md b/docs/book/v2/migration.md
index 1852510f..ef1439d0 100644
--- a/docs/book/v2/migration.md
+++ b/docs/book/v2/migration.md
@@ -1,4 +1,4 @@
-# Migration to version 2
+# Migration to Version 2
If you are only using the PSR-7 implementations (e.g., `Request`, `Response`,
`ServerRequest`, etc.), migrating to v2 can be done by updating your
@@ -64,7 +64,7 @@ to provide these capabilities instead. Usage is similar, but the
`RequestHandlerRunner` provides better error handling, and integration with
emitters.
-### ServerRequestFactory methods
+### ServerRequestFactory Methods
A number of public static methods have been removed from
`ServerRequestFactory`. The following table details the methods removed, and
diff --git a/docs/book/v2/overview.md b/docs/book/v2/overview.md
index de8d5715..2969f567 100644
--- a/docs/book/v2/overview.md
+++ b/docs/book/v2/overview.md
@@ -1,4 +1,4 @@
-# zend-diactoros: HTTP Messages
+# Overview
`zend-diactoros` is a PHP package containing implementations of the
[PSR-7 HTTP message interfaces](https://www.php-fig.org/psr/psr-7/),
diff --git a/docs/book/v2/serialization.md b/docs/book/v2/serialization.md
index ba22c377..aa3b5576 100644
--- a/docs/book/v2/serialization.md
+++ b/docs/book/v2/serialization.md
@@ -32,7 +32,7 @@ the following static methods:
The deserialization methods (`fromArray()`) will raise exceptions if errors occur while parsing the
message.
-### Example usage
+### Example Usage
Array serialization can be usesful for log messages:
diff --git a/docs/book/v2/usage.md b/docs/book/v2/usage.md
index d0f38258..3ee41f12 100644
--- a/docs/book/v2/usage.md
+++ b/docs/book/v2/usage.md
@@ -60,7 +60,7 @@ illustration of a possible implementation.)
Server-side applications will need to marshal the incoming request based on superglobals, and will
then populate and send a response.
-### Marshaling an incoming request
+### Marshaling an incoming Request
PHP contains a plethora of information about the incoming request, and keeps that information in a
variety of locations. `Zend\Diactoros\ServerRequestFactory::fromGlobals()` can simplify marshaling
@@ -94,7 +94,7 @@ in the name were renamed with underlines. By getting the cookies directly from t
access to the original cookies in the way you set them in your application and they are send by the user
agent.
-### Manipulating the response
+### Manipulating the Response
Use the response object to add headers and provide content for the response. Writing to the body
does not create a state change in the response, so it can be done without capturing the return
diff --git a/mkdocs.yml b/mkdocs.yml
index a063c0c6..ad26995e 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -5,7 +5,7 @@ extra:
versions:
- v2
- v1
-pages:
+nav:
- Home: index.md
- v2:
- Overview: v2/overview.md
@@ -16,7 +16,8 @@ pages:
- "Custom Responses": v2/custom-responses.md
- Serialization: v2/serialization.md
- API: v2/api.md
- - Migration: v2/migration.md
+ - Migration:
+ - 'Migration to Version 2': v2/migration.md
- v1:
- Overview: v1/overview.md
- Installation: v1/install.md