Flesh out the README and add a logo

Author: psftw

README-short.txt

@@ -1 +1 @@
-This image ships a minimal Haskell (GHC) toolchain consisting of alex, cabal, ghc, and happy. Suitable for providing a Haskell development environment or for deploying projects using Cabal/Hackage. 
+Haskell is an advanced purely-functional programming language.  This image contains a minimal Haskell (GHC) toolchain consisting of alex, cabal, ghc, and happy.

README.md

@@ -1,18 +1,22 @@
-## Synopsis
+## What is Haskell?
 
-This docker image ships a minimal Haskell toolchain.
+![image](https://github.com/darinmorrison/docker-haskell/blob/docker-library/logo.png?raw=true)
 
-### Use Cases
+Haskell is an advanced purely-functional programming language. An open-source
+product of more than twenty years of cutting-edge research, it allows rapid
+development of robust, concise, correct software. With strong support for
+integration with other languages, built-in concurrency and parallelism,
+debuggers, profilers, rich libraries and an active community, Haskell makes it
+easier to produce flexible, maintainable, high-quality software.
 
-This image can be used in the following ways:
+The Glorious Glasgow Haskell Compilation System (GHC) is a state-of-the-art,
+open source, compiler and interactive environment for the functional language
+Haskell.  GHC includes an optimising compiler (`ghc`), an interactive
+environment (`ghci`), and a convenient script runner (`runghc`).
 
-*   **As a containerized Haskell development environment**
+> [haskell.org](http://www.haskell.org)
 
-*   **As a container in which to build and run Haskell apps locally or deploy remotely**
-
-*   **As a base image for other containers depending on the Haskell toolchain**
-
-### Contents
+> [Glasgow Haskell Compiler](http://www.haskell.org/ghc)
 
 The default configuration of this image provides the following packages:
 
@@ -22,3 +26,50 @@ The default configuration of this image provides the following packages:
 | `cabal-install` | `1.20.0.3` |
 | `happy`         | `1.19.4`   |
 | `ghc`           | `7.8.3`    |
+
+## How to use this image
+
+Directly run `ghci`.
+
+    $ docker run -it --rm haskell:7.8
+    GHCi, version 7.8.3: http://www.haskell.org/ghc/  :? for help
+    Loading package ghc-prim ... linking ... done.
+    Loading package integer-gmp ... linking ... done.
+    Loading package base ... linking ... done.
+    Prelude>
+
+Dockerize an application on Hackage with a Dockerfile that inherits from the
+base image.
+
+    FROM haskell:7.8
+    RUN cabal update && cabal install MazesOfMonad
+    VOLUME /root/.MazesOfMonad
+    ENTRYPOINT ["/root/.cabal/bin/mazesofmonad"]
+
+Develop and ship your Haskell application with a Dockerfile that utilizes the
+build cache for quick iteration.
+
+    FROM haskell:7.8
+
+    RUN cabal update
+
+    # Add .cabal file
+    ADD ./server/snap-example.cabal /opt/server/snap-example.cabal
+
+    # Docker will cache this command as a layer, freeing us up to
+    # modify source code without re-installing dependencies
+    RUN cd /opt/server && cabal install --only-dependencies -j4
+
+    # Add and Install Application Code
+    ADD ./server /opt/server
+    RUN cd /opt/server && cabal install
+
+    # Add installed cabal executables to PATH
+    ENV PATH /root/.cabal/bin:$PATH
+
+    # Default Command for Container
+    WORKDIR /opt/server
+    CMD ["snap-example"]
+
+This example can be reviewed in more depth at
+https://github.com/darinmorrison/docker-haskell/tree/docker-library/examples/7.8.3/snap