Add README.md
and remove README.
Change-Id: I51ee6ce6dec9fdab228b9de3d2a3a95535c36b85
Reviewed-on: https://go-review.googlesource.com/121002
Reviewed-by: Ian Lance Taylor <iant@golang.org>
diff --git a/README b/README
deleted file mode 100644
index cfef67a..0000000
--- a/README
+++ /dev/null
@@ -1 +0,0 @@
-Nothing to see here. Yet.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..64929ad
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# Go Debug
+This repository holds utilities and libraries for debugging Go programs.
+
+**WARNING!**
+Please expect breaking changes and unstable APIs.
+Most of them are currently are at an early, *experimental* stage.
+
+#### Report Issues & Send Changes
+* This repository uses Gerrit for code changes. To learn how to submit changes to this repository, see https://golang.org/doc/contribute.html.
+* The main issue tracker for the tools repository is located at https://github.com/golang/go/issues.
+Prefix your issue with "x/debug/(your subdir):" in the subject line, so it is easy to find.
+* Feature requests should preliminary be discussed on [golang-nuts](https://groups.google.com/forum/#!forum/golang-nuts) mailing list.
