Add Guides

[seanmonstar]

Create a series of guides explaining different topics in hyper, along the lines of https://tokio.rs/docs/getting-started/tokio/

Some topics that seem like good ideas, though organization can be re-worked:

• Server
  • Hello World
  • Echo
  • File Server/Reverse proxy?
  • Advanced specifics on server's Http, Service, and NewService
• Client
  • Getting Started
  • Posting a Request Body
  • Configuration/Using TLS

[drusellers]

OMG YES

[pimeys]

I'd add "Stopping a server cleanly".

[seanmonstar]

I actually wonder if some of the topics are too small (the routing guide I just wrote feels so tiny). Maybe instead, a list of sufficiently more complicated topics that explore all of the required topics, such as:

1. hello world
2. echo
3. file serving

They would definitely cover all the original topics, but it may not be obvious from their titles?

[hjr3]

I think showing the examples is a good place to start. One of the more challenging things about understanding futures, tokio and hyper is context. Examples, such a hello world, show more of that context and give people a better chance of solving their problem.

I do think there is value in doing a deep-dives on a particular topic, but I think examples and spelunking through source is good enough until things really stabilize.

[seanmonstar]

The docs that will exist for the v0.11 release are done. Clearly, there is always room for more, and better, docs.