aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorKevin Burke <kev@inburke.com>2017-07-18 21:03:19 -0700
committerKevin Burke <kev@inburke.com>2017-09-27 05:40:07 +0000
commit68e087e2a5786de2c035ed544b1c5a42e31f1933 (patch)
tree4d158a70407dd0e28566129656506e75e36aa964 /README.md
parente531a2a1c15f94033f6fa87666caeb19a688175f (diff)
downloadgolang-x-tools-68e087e2a5786de2c035ed544b1c5a42e31f1933.tar.gz
README: switch to Markdown and add links
Move the README to README.md so Gerrit can render it; currently Gerrit only renders files named exactly "README.md" (for example at https://go.googlesource.com/go). 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 https://go.googlesource.com/tools or https://github.com/golang/tools figure out how to get started with development. Change-Id: I778202d9759df5cf79e86b8524046e108aa3db3d Reviewed-on: https://go-review.googlesource.com/49852 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
Diffstat (limited to 'README.md')
-rw-r--r--README.md27
1 files changed, 27 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 000000000..20be9e1ab
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# Go Tools
+
+This subrepository holds the source for various packages and tools that support
+the Go programming language.
+
+Some of the tools, `godoc` and `vet` for example, are included in binary Go
+distributions.
+
+Others, including the Go `guru` and the test coverage tool, can be fetched with
+`go get`.
+
+Packages include a type-checker for Go and an implementation of the
+Static Single Assignment form (SSA) representation for Go programs.
+
+## Download/Install
+
+The easiest way to install is to run `go get -u golang.org/x/tools/...`. You can
+also manually git clone the repository to `$GOPATH/src/golang.org/x/tools`.
+
+## Report Issues / Send Patches
+
+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/tools/(your
+subdir):" in the subject line, so it is easy to find.