Merge branch 'document-release-process' into 'master'

Document release process

Closes #1

See merge request !11

README.md

@@ -97,6 +97,19 @@ to implementation details of the Go standard library (specifically,
 the ouput of gzip). **Use the same Go version as .gitlab-ci.yml (Go
 1.8)** when generating new client libraries for a merge request.
+### Build process
+
+After you change or add a .proto file you need to re-generate the Go
+and Ruby libraries before committing your change.
+
+```
+# Install dependencies
+_support/install-protoc
+
+# Re-generate Go and Ruby libraries
+_support/generate-from-proto
+```
+
 ## How to deprecate an RPC call
 See [DEPRECATION.md](DEPRECATION.md).

RELEASE.md

+# Gitaly-proto release process
+
+## Requirements
+
+- Ruby
+- Bundler
+- Go 1.8
+
+## 1. Install dependencies
+
+If you have done a release before this may not be needed.
+
+```
+_support/install-protoc
+```
+
+## 2. Release
+
+This will:
+
+- do a final consistency check
+- create a version bump commit
+- create a tag
+- build the gem
+- ask for confirmation
+- push the gem and the tag out to the world
+
+```
+_support/release 1.2.3
+```