First bits of akka-http-core Scala server documentation for review

/cc @sirthias 
What I wanted to say is that you can treat streams in an idiomatic way similar to the Scala collections. :) Will improve.