Make github README canonical for s-http-client

Was fooling around with `pandoc` and I thought I'd use it to update the `README.md` with the old HTML documentation. 

It was simply converted using `pandoc -f html -t markdown index.html` and then I've removed most of the stale links and info.