Neaten up docs (#112)

* Neaten up docs
* Hiya

Author: lovelydinosaur

README.md

@@ -6,10 +6,6 @@
 
 ---
 
-*The following is a [design proposal](https://www.encode.io/httpnext/) and is not yet complete. The work is well underway, tho be aware that some parts of the codebase are still under development.*
-
----
-
 A complete HTTP framework for Python.
 
 *Installation...*
@@ -51,35 +47,26 @@ Serving on http://127.0.0.1:8080/ (Press CTRL+C to quit)
 
 The [HTTPX 1.0 design proposal](https://www.encode.io/httpnext/) is now available.
 
-* [Quickstart](https://www.encode.io/httpnext/quickstart.md)
-* [Clients](https://www.encode.io/httpnext/clients.md)
-* [Servers](https://www.encode.io/httpnext/servers.md)
-* [Requests](https://www.encode.io/httpnext/requests.md)
-* [Responses](https://www.encode.io/httpnext/responses.md)
-* [URLs](https://www.encode.io/httpnext/urls.md)
-* [Headers](https://www.encode.io/httpnext/headers.md)
-* [Content Types](https://www.encode.io/httpnext/content-types.md)
-* [Connections](https://www.encode.io/httpnext/connections.md)
-* [Network Backends](https://www.encode.io/httpnext/networking.md)
+* [Quickstart](https://www.encode.io/httpnext/quickstart)
+* [Clients](https://www.encode.io/httpnext/clients)
+* [Servers](https://www.encode.io/httpnext/servers)
+* [Requests](https://www.encode.io/httpnext/requests)
+* [Responses](https://www.encode.io/httpnext/responses)
+* [URLs](https://www.encode.io/httpnext/urls)
+* [Headers](https://www.encode.io/httpnext/headers)
+* [Content Types](https://www.encode.io/httpnext/content-types)
+* [Connections](https://www.encode.io/httpnext/connections)
+* [Network Backends](https://www.encode.io/httpnext/networking)
 
 ---
 
 # Collaboration
 
-The design repository for this work is currently private. We are looking towards a development model that encourages a calm focused working environment, and are currently taking a little time to work through expectations & boundaries for contributions to the codebase.
-
----
-
-## Background
-
-If you've been working with 0.x versions of HTTPX you'll notice significant API differences.
-
-Version 1.0 provides a much more tightly constrained API. It has a lighter installation footprint, far more obvious type annotations, and a lower overall complexity.
+The repository for this project is currently private.
 
-For example:
+We’re looking at creating paid opportunities for working on open source software *which are properly compensated, flexible & well balanced.*
 
-* Client code [before](https://github.com/encode/httpx/blob/master/httpx/_client.py) and [after](https://github.com/encode/httpnext/blob/dev/src/httpx/_client.py).
-* Response code [before](https://github.com/encode/httpx/blob/master/httpx/_models.py#L515) and [after](https://github.com/encode/httpnext/blob/dev/src/httpx/_response.py).
+If you're interested in a position working on this project, please <a href="mailto:kim@encode.io">send an intro</a>.
 
 ---
 

docs/about.md

@@ -1,6 +1,6 @@
 # About
 
-This work is a design proposal for an httpx 1.0 release.
+This work is a design proposal for an `httpx` 1.0 release.
 
 ---
 
@@ -16,5 +16,4 @@ The rights of the author have been asserted.
 
 ---
 
-<span class="link-prev">← [Networking](networking.md)</span>
-<span>&nbsp;</span>
+<p align="center"><i><a href="https://www.encode.io/httpnext">home</a><i></p>

docs/index.md

@@ -78,17 +78,6 @@ Serving on http://127.0.0.1:8080/ (Press CTRL+C to quit)
 
 ---
 
-Some things HTTPX supports...
-
-* Use it as an HTTP client, to interact with the web.
-* Use it as an HTTP server, to create web APIs, applications, or websites.
-* Use it as a general purpose toolkit, for working with URLs, query parameters & forms.
-* Use it to build networking components, such as proxies.
-
-Components provided by HTTPX are immutable by default, and provide tightly typed interfaces. The package has a light installation footprint & minimal stdlib imports.
-
----
-
 # Documentation
 
 * [Quickstart](quickstart.md)
@@ -101,18 +90,17 @@ Components provided by HTTPX are immutable by default, and provide tightly typed
 * [Content Types](content-types.md)
 * [Connections](connections.md)
 * [Network Backends](networking.md)
-* [About](about.md)
 
 ---
 
 # Collaboration
 
 The repository for this project is currently private.
 
-We’re looking at creating paid opportunities for working on open source software which are properly compensated, flexible & well balanced.
+We’re looking at creating paid opportunities for working on open source software *which are properly compensated, flexible & well balanced.*
 
-If you're interested in collaborating, <a href="mailto:kim@encode.io">send an intro</a>.
+If you're interested in a position working on this project, please send an intro: `kim`&nbsp;&#x40;&nbsp;`encode.io`.
 
 ---
 
-<p align="center"><i>This design work is <a href="https://www.encode.io/httpnext/about/">not yet licensed</a> for reuse.</i><br/>&mdash; 🦋 &mdash;</p>
+<p align="center"><i>This design work is <a href="https://www.encode.io/httpnext/about">not yet licensed</a> for reuse.</i><br/>&mdash; 🦋 &mdash;</p>

docs/networking.md

@@ -378,5 +378,4 @@ Custom network backends can also be used to provide functionality such as handli
 ---
 
 <span class="link-prev">← [Connections](connections.md)</span>
-<span class="link-next">[About](about.md) →</span>
 <span>&nbsp;</span>