diff --git a/golang/README-content.md b/golang/README-content.md
index 8b1378917..f6ac7342d 100644
--- a/golang/README-content.md
+++ b/golang/README-content.md
@@ -1 +1,17 @@
+# What is Go?
+Go, also called golang, is a programming language initially developed at Google in 2007 by Robert Griesemer, Rob Pike, and Ken Thompson. It is a statically-typed language with syntax loosely derived from that of C, adding garbage collection, type safety, some dynamic-typing capabilities, additional built-in types such as variable-length arrays and key-value maps, and a large standard library.
 
+> [http://en.wikipedia.org/wiki/Go_(programming_language)]
+
+# How to use this image
+
+## Start a go instance running in your app
+
+For this image, the most straight-forward use is to use a golang container as both the build environment as well as the runtime environment. In your Dockerfile, you can do something along the lines of the following will compile and run your project.
+
+    FROM golang
+    
+    ADD . /usr/src/myapp
+    WORKDIR /usr/src/myapp
+    RUN go build
+    CMD ["./myapp"]
diff --git a/golang/README-short.txt b/golang/README-short.txt
index 8b1378917..15bb68254 100644
--- a/golang/README-short.txt
+++ b/golang/README-short.txt
@@ -1 +1 @@
-
+Go (golang) is a general purpose, higher-level, imperative programming language.
diff --git a/golang/README.md b/golang/README.md
index 2f030a263..e42f6303b 100644
--- a/golang/README.md
+++ b/golang/README.md
@@ -1,4 +1,20 @@
+# What is Go?
+Go, also called golang, is a programming language initially developed at Google in 2007 by Robert Griesemer, Rob Pike, and Ken Thompson. It is a statically-typed language with syntax loosely derived from that of C, adding garbage collection, type safety, some dynamic-typing capabilities, additional built-in types such as variable-length arrays and key-value maps, and a large standard library.
 
+> [http://en.wikipedia.org/wiki/Go_(programming_language)]
+
+# How to use this image
+
+## Start a go instance running in your app
+
+For this image, the most straight-forward use is to use a golang container as both the build environment as well as the runtime environment. In your Dockerfile, you can do something along the lines of the following will compile and run your project.
+
+    FROM golang
+    
+    ADD . /usr/src/myapp
+    WORKDIR /usr/src/myapp
+    RUN go build
+    CMD ["./myapp"]
 
 # Issues and Contributing