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

/cc @sirthias 
I agree, isn't it enough to browse around in the API docs?