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

/cc @sirthias 
We should also probably add a warning section that the user should not violate the one-to-one nature of request-response (e.g. emitting 3 responses for one request, or munching requests)