calcite-avatica-go git commit: Add instructions for uploading release artifacts

[fr...@apache.org]

Repository: calcite-avatica-go
Updated Branches:
  refs/heads/master 273c53f62 -> aa99d29a4


Add instructions for uploading release artifacts


Project: http://git-wip-us.apache.org/repos/asf/calcite-avatica-go/repo
Commit: http://git-wip-us.apache.org/repos/asf/calcite-avatica-go/commit/aa99d29a
Tree: http://git-wip-us.apache.org/repos/asf/calcite-avatica-go/tree/aa99d29a
Diff: http://git-wip-us.apache.org/repos/asf/calcite-avatica-go/diff/aa99d29a

Branch: refs/heads/master
Commit: aa99d29a45f6e847616d7389e892f475612c7425
Parents: 273c53f
Author: Francis Chuang <fr...@apache.org>
Authored: Mon Apr 23 10:40:07 2018 +1000
Committer: Francis Chuang <fr...@apache.org>
Committed: Mon Apr 23 10:40:07 2018 +1000

----------------------------------------------------------------------
 site/go_development.md | 48 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 47 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/calcite-avatica-go/blob/aa99d29a/site/go_development.md
----------------------------------------------------------------------
diff --git a/site/go_development.md b/site/go_development.md
index 115c4d5..501e7a3 100644
--- a/site/go_development.md
+++ b/site/go_development.md
@@ -70,4 +70,50 @@ From the root of the repository, run `./make-release-artifacts.sh`.
 
 You will be asked to select the tag to build release artifacts for. The latest tag is automatically selected if no tag is selected.
 
-The release artifacts will be placed in a folder named for the release within the `dist/` folder.
\ No newline at end of file
+The release artifacts will be placed in a folder named for the release within the `dist/` folder.
+
+## Important things to note before uploading a release
+The name of the release folder must be in the following format: `apache-calcite-avatica-go-$version`. The version must 
+include release candidate identifiers such as `-rc0`, if they are present.
+
+The files inside the release folder must have any release candidate identifiers such as `-rc1` removed, even if the
+release is a release candidate. `src` must also be added to the filename.
+
+For example, if we are uploading the `apache-calcite-avatica-go-3.0.0-rc1` folder, the files must be named 
+`apache-calcite-acatica-go-src-3.0.0.tar.gz`. Note the inclusion of `src` in the filename.
+
+The tar.gz must be named `apache-calcite-avatica-go-src-$version.tar.gz`. 
+
+There must be a GPG signature for the tar.gz named: `apache-calcite-avatica-go-src-$version.tar.gz.asc`
+
+There must be a MD5 hash for the tar.gz named: `apache-calcite-avatica-go-src-$version.tar.gz.md5`
+
+There must be a SHA256 hash for the tar.gz named: `apache-calcite-avatica-go-src-$version.tar.gz.sha256`
+
+## Uploading release artifacts to dev for voting
+`svn` must be installed in order to upload release artifacts.
+
+1. Check out the Calcite dev release subdirectory: `svn co "https://dist.apache.org/repos/dist/dev/calcite/" calcite-dev`.
+
+2. Move the release folder under `dist/` into the `calcite-dev` folder.
+
+3. Add the new release to the svn repository: `svn add apache-calcite-avatica-go-3.0.0-rc0`. Remember to change the folder name to the
+correct release in the command.
+
+4. Commit to upload the artifacts: `svn commit -m "apache-calcite-avatica-go-3.0.0-rc0" --username yourapacheusername --force-log`
+Note the use of `--force-log` to suppress the svn warning, because the commit message is the same as the name of the directory.
+
+## Promoting a release after voting
+`svn` must be installed in order to upload release artifacts.
+
+NOTE: Only official releases that has passed a vote may be uploaded to the release directory.
+
+1. Check out the Calcite release directory: `svn co "https://dist.apache.org/repos/dist/release/calcite/" calcite-release`.
+
+2. Copy the release into the `calcite-release` folder. Remember to check the name of the release's folder to ensure that it is in
+the correct format.
+
+3. Add the release to the svn repository: `svn add apache-calcite-avatica-go-3.0.0`. Remember to change the folder name to the
+correct release in the command.
+
+4. Commit to upload the artifacts: `svn commit -m "Release apache-calcite-avatica-go-3.0.0" --username yourapacheusername`.
\ No newline at end of file