Skip to content

Revamp the website guides #3411

Open
Open
@seanmonstar

Description

@seanmonstar

The guides at https://hyper.rs/guides/1 could use a revamp. They don't explain nearly enough for someone trying to learn. It'd be good for them to be broken up by topic, but also be able to build up to something useful. Here's the outline of guides I've imagined:

  • Init
    • Setup
    • Runtime: Bring Your Own, or hyper_util::rt::Tokio*
  • Server
    • Hello, world!
    • Routing?
    • Streaming (Echo)
    • Testing (your Service)
  • Client
    • Fetch
    • Post
    • Connectors, Pools, HTTPS
  • Bodies
    • Common
    • Advanced: Frames
  • Integrating?
    • Service
    • Middleware. Tower? Client/Server split?
    • Observability (tracing, metrics, etc)
  • Proxy: Put it all together
  • Upgrading from 0.14

Metadata

Metadata

Assignees

No one assigned

    Labels

    A-docsArea: documentation.E-mediumEffort: medium. Some knowledge of how hyper internal works would be useful.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions