README: add more description

Move the README to so Gerrit can render it; currently
Gerrit only renders files named exactly "" (for example at

Add more links to the README explaining how to file issues,
how to submit code changes, where to download the code to and
how to get it. Hopefully this should help people who go to or
figure out how to get started with development.

Change-Id: I390d4bd84c9fd7d0bd3f3f56f63ea8482d03a725
Reviewed-by: Kevin Burke <>
diff --git a/README b/README
deleted file mode 100644
index 4620380..0000000
--- a/README
+++ /dev/null
@@ -1,3 +0,0 @@
-This repository holds supplementary Go image libraries.
-To submit changes to this repository, see
diff --git a/ b/
new file mode 100644
index 0000000..0a312b4
--- /dev/null
+++ b/
@@ -0,0 +1,17 @@
+# Go Images
+This repository holds supplementary Go image libraries.
+## Download/Install
+The easiest way to install is to run `go get -u`. You can
+also manually git clone the repository to `$GOPATH/src/`.
+## Report Issues / Send Patches
+This repository uses Gerrit for code changes. To learn how to submit changes to
+this repository, see
+The main issue tracker for the image repository is located at
+ Prefix your issue with "x/image:" in the
+subject line, so it is easy to find.