Write beginner friendly documentation for HTTP client

akka / akka-http

The Streaming-first HTTP server/module of Akka

https://doc.akka.io/docs/akka-http

Other

1.34k stars 594 forks source link

Write beginner friendly documentation for HTTP client #241

Open ktoso opened 7 years ago

ktoso commented 7 years ago

Issue by jrudolph Wednesday Feb 11, 2015 at 14:05 GMT Originally opened as https://github.com/akka/akka/issues/16859

Migrated from spray/spray#676 which contains several ideas about how to improve the existing (spray) documentation and what beginners would expect when starting with an HTTP client API.

/cc @sirthias

ktoso commented 7 years ago

Comment by sirthias Monday Jul 27, 2015 at 09:09 GMT

Main point is probably:

add examples and explain them
add helpers on how to choose which client-side API level