Add complete TOC and stubs

Author: ddeboer

docs/clients/curl-client.md

@@ -0,0 +1 @@
+# CURL Client

docs/clients/guzzle5-adapter.md

@@ -0,0 +1 @@
+# Guzzle5 Adapter

docs/clients/guzzle6-adapter.md

@@ -0,0 +1 @@
+# Guzzle6 Adapter

docs/clients/mock-client.md

@@ -0,0 +1 @@
+# Mock Client

docs/clients/react-adapter.md

@@ -0,0 +1 @@
+# React Adapter

docs/clients/socket-client.md

@@ -0,0 +1 @@
+# Socket Client

docs/components/adapter-integration-tests.md

@@ -0,0 +1,3 @@
+# Adapter Integration Tests
+
+TODO

docs/components/client-common.md

@@ -0,0 +1,3 @@
+# Client Common
+
+TODO

docs/components/authentication.md renamed to docs/components/message.md

@@ -1,19 +1,29 @@
-# Authentication
+# Message
+
+This package contains various PSR-7 tools which might be useful in an HTTP workflow:
+
+* Authentication method implementations
+* Various Stream encoding tools
+* Message decorators
+* Message factory implementations for Guzzle PSR-7 and Diactoros
+* Cookie implementation
+
+## Authentication
 
 The Authentication component allows you to to implement authentication methods which can simply update the request
 with authentication detail (for example by adding an `Authorization` header).
 This is useful when you have to send multiple requests to the same endpoint. Using an authentication implementation,
 these details can be separated from the actual requests.
 
 
-## Installation
+### Installation
 
 ```
 $ composer require php-http/message
 ```
 
 
-## Authentication methods
+### Authentication methods
 
 Method           | Parameters                                        | Behavior
 ---------------- | ------------------------------------------------- | --------
@@ -28,15 +38,15 @@ Matching         | An authentication instance and a matcher callback | Behavior
 [2]: http://www.xml.com/pub/a/2003/12/17/dive.html
 
 
-## Integration with HTTPlug
+### Integration with HTTPlug
 
 Normally requests must be authenticated "by hand" which is not really convenient.
 
 If you use HTTPlug, you can integrate this component into the client using the
 [authentication plugin](/httplug/plugins/authentication).
 
 
-## Examples
+### Examples
 
 General usage looks like the following:
 
@@ -48,7 +58,7 @@ $authentication->authenticate($request);
 ```
 
 
-### Basic Auth
+#### Basic Auth
 
 ``` php
 use Http\Message\Authentication\BasicAuth;
@@ -57,7 +67,7 @@ $authentication = new BasicAuth('username', 'password');
 ```
 
 
-### Bearer
+#### Bearer
 
 ``` php
 use Http\Message\Authentication\Bearer;
@@ -66,7 +76,7 @@ $authentication = new Bearer('token');
 ```
 
 
-### WSSE
+#### WSSE
 
 ``` php
 use Http\Message\Authentication\Wsse;
@@ -75,7 +85,7 @@ $authentication = new Wsse('username', 'password');
 ```
 
 
-### Query Params
+#### Query Params
 
 `http://api.example.com/endpoint?access_token=9zh987g86fg87gh978hg9g79`
 
@@ -94,7 +104,7 @@ $authentication = new QueryParams([
 
 
 
-### Chain
+#### Chain
 
 The idea behind this authentication method is that in some cases you might need to
 authenticate the request with multiple methods.
@@ -115,7 +125,7 @@ $authentication = new Chain($authenticationChain);
 ```
 
 
-### Matching
+#### Matching
 
 With this authentication method you can conditionally add authentication details to your request by passing a callable
 to it. When a request is passed, the callable is called and used as a boolean value in order to decide whether
@@ -152,7 +162,7 @@ $authentication = Matching::createUrlMatcher(new AuthenticationMethod(), '\/api'
 ```
 
 
-## Implement your own
+### Implement your own
 
 Implementing an authentication method is easy: only one method needs to be implemented.
 

docs/components/promise.md

@@ -0,0 +1,5 @@
+# Promise
+
+Promise used for asynchronous HTTP requests.
+
+This will eventually be removed/deprecated and replaced with the upcoming Promise PSR.

docs/httplug/plugins/encoding.md

@@ -0,0 +1,3 @@
+# Cache Plugin
+
+TODO

docs/httplug/plugins/authentication.md renamed to docs/plugins/authentication.md

@@ -0,0 +1,3 @@
+# Content-Length Plugin
+
+TODO

docs/plugins/cache.md

@@ -0,0 +1,3 @@
+# Decoder Plugin
+
+TODO

docs/plugins/content-length.md

@@ -0,0 +1,3 @@
+# History Plugin
+
+TODO: explain the error plugin

docs/httplug/plugins/cookie.md renamed to docs/plugins/cookie.md

@@ -0,0 +1,3 @@
+# Journal
+
+TODO

docs/plugins/decoder.md

@@ -0,0 +1,3 @@
+# Logger Plugin
+
+TODO

docs/httplug/plugins/error.md renamed to docs/plugins/error.md

@@ -9,3 +9,39 @@ markdown_extensions:
           permalink: true
     - sane_lists
     - admonition
+
+pages:
+    - Home: index.md
+    - HTTPlug:
+        - httplug/index.md
+        - httplug/migrating.md
+        - httplug/tutorial.md
+        - httplug/utils.md
+        - httplug/virtual-package.md
+    - 'Clients & Adapters':
+        - clients/curl-client.md
+        - clients/mock-client.md
+        - clients/socket-client.md
+        - clients/guzzle5-adapter.md
+        - clients/guzzle6-adapter.md
+        - clients/react-adapter.md
+    - Plugins:
+        - plugins/index.md
+        - plugins/authentication.md
+        - plugins/cache.md
+        - plugins/content-length.md
+        - plugins/cookie.md
+        - plugins/decoder.md
+        - plugins/error.md
+        - plugins/history.md
+        - plugins/journal.md
+        - plugins/logger.md
+        - plugins/redirect.md
+        - plugins/retry.md
+        - plugins/stopwatch.md
+    - Other Components: components/
+#        - components/discovery.md
+#        - components/message.md
+#        - components/message-factory.md
+#        - components/promise.md
+