diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+http-client-openssl
+===================
+
+Full tutorial docs on the http-client package set are available at:
+https://github.com/commercialhaskell/jump/blob/master/doc/http-client.md
+
+This package is an alternative to
+[http-client-tls](https://www.stackage.org/package/http-client-tls) for those
+wishing to make secure connections with the OpenSSL library.
diff --git a/http-client-openssl.cabal b/http-client-openssl.cabal
--- a/http-client-openssl.cabal
+++ b/http-client-openssl.cabal
@@ -1,7 +1,7 @@
 name:                http-client-openssl
-version:             0.2.0.1
+version:             0.2.0.2
 synopsis:            http-client backend using the OpenSSL library.
-description:         Intended for use by higher-level libraries.
+description:         Hackage documentation generation is not reliable. For up to date documentation, please see: <http://www.stackage.org/package/http-client>.
 homepage:            https://github.com/snoyberg/http-client
 license:             MIT
 license-file:        LICENSE
@@ -10,7 +10,7 @@
 category:            Network
 build-type:          Simple
 cabal-version:       >=1.10
-extra-source-files:  ChangeLog.md
+extra-source-files:  README.md ChangeLog.md
 
 library
   exposed-modules:     Network.HTTP.Client.OpenSSL