Merge pull request #375 from froschdesign/hotfix/docs

Updates for documentation

Author: michalbundyra

docs/book/index.html

@@ -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`

docs/book/v1/api.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.

docs/book/v1/custom-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.

docs/book/v1/emitting-responses.md

@@ -1,4 +1,4 @@
-# Installation and Requirements
+# Installation
 
 Install this library using composer:
 

docs/book/v1/install.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

docs/book/v1/overview.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:
 

docs/book/v1/serialization.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
 >

docs/book/v1/usage.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`

docs/book/v2/api.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.