First Getting started guide!

Author: abourget

Getting_Started_for_Windows.md

@@ -0,0 +1,166 @@
+Getting Started with Golang - Windows
+=====================================
+
+Install Go
+----------
+
+Go to:
+
+* http://golang.org/dl/
+
+and download and install the .MSI package WITH ALL DEFAULT. Just hit
+NEXT.
+
+* If a previous version was already installed, go to "Add / Remove
+  Programs", and remove it beforehand.
+
+The GOPATH is where all your Go code will live.
+
+Create new folder in C:\ named "GoPath"
+
+Go to the "System" control panel, click the "Advanced" tab. Select
+"Environment Variables" and under "System variables":
+
+ * add GOPATH variable, set it to "C:\GoPath"
+ * add GO15VENDOREXPERIMENT, set it to "1"
+
+
+Install Git
+-----------
+
+Go to:
+
+* http://git-scm.com/downloads
+
+Download and install:
+
+* BUT HEY! when asked to select how to "Adjust your PATH environment",
+  select the SECOND choice which is "Use Git from the Windows Command
+  Prompt".
+
+* Continue on with the defaults.
+
+Open a NEW terminal (with new env vars), paste this in to install
+those sweet tools:
+
+    go get -u -ldflags -H=windowsgui github.com/nsf/gocode/...
+    go get -u github.com/abourget/godef/...
+    go get -u golang.org/x/tools/cmd/...
+
+
+Install Atom
+------------
+
+Atom has the best support for coding in Go, has excellent plugins and
+works across platforms. Throw Sublime Text away and use Atom.
+
+Go to:
+
+* https://atom.io/
+
+Download and install (it will open), and once in there:
+
+ * In the Welcome Guide
+
+   * Click "Install package"
+
+     * Click "Open Installer"
+
+   * Search "go-plus" (by joefitzgerald)
+
+   * Install it
+
+
+Setup `Git` and `bash` properly
+-------------------------------
+
+Right click on the desktop, and select "Git Bash Here"
+
+Run
+
+    atom ~/.profile
+
+This opens Atom.  Tweak `~/.profile` to look like these, and *save* the file:
+
+    export GOPATH=/c/GoPath
+    export PATH=/c/GoPath/bin:$PATH
+    eval $(ssh-agent)
+    ssh-add $HOME/.ssh/id_rsa
+
+Back to `Git Bash` terminal, run:
+
+    atom ~/.gitconfig
+
+Edit the `~/.gitconfig` file to make sure similar lines are in there:
+
+    [user]
+	name = Your Name
+	email = [email protected]
+
+Save the files, and exit.
+
+
+Setup GitHub authentication
+---------------------------
+
+
+### Generate a new key
+
+Run:
+
+    cat $HOME/.ssh/id_rsa.pub
+
+If you see `No such file or directory`, continue on, otherwise skip
+this `ssh-keygen` step and go to `Register your key on GitHub`.
+
+Still in "Git Bash", run:
+
+    ssh-keygen
+
+Accept the default file name (hit ENTER).  This key gives access to
+all your github repos. Secure it with a password when asked.
+
+  * This password never leaves your computer, the key shouldn't
+    either, but if lost, it is encrypted with this password.
+
+
+### Register your key on GitHub
+
+Run:
+
+    cat $HOME/.ssh/id_rsa.pub
+
+Go to:
+
+* https://github.com/settings/ssh
+
+Click "Add SSH key" (at the top right of the box).
+
+Copy the `ssh-rsa .......` in the `Key` input field. Don't fill in
+`Title` (it will use the key comment).
+
+GitHub will ask you to confirm with your GitHub password.
+
+
+Check out your first project, get ready to run and build
+--------------------------------------------------------
+
+Open "Git Gui" (right click on the Desktop, or run `git gui` in Git
+bash)
+
+Select `Clone Existing Repository`, punch in:
+
+* Source location: `[email protected]:abourget/getting-started-with-golang`
+* Target directory: `C:\GoPath\src\github.com\abourget\getting-started-with-golang`
+
+Go to Atom, select "File" -> "Add Project Folder", and navigate to
+`C:\GoPath\src\github.com\abourget\getting-started-with-golang`.
+
+In `Git Bash`, run:
+
+    cd /c/GoPath/src/github.com/abourget/getting-started-with-golang
+    go install -v
+    getting-started-with-golang
+
+Modify `main.go` in this repository and rerun `go install -v` to compile and
+`getting-started-with-golang` to re-execute the program.

README.md

@@ -1 +1,3 @@
-# getting-started-with-golang
+# Getting Started with Go
+
+Guide for [Getting_Started_for_Windows.md|Windows]

main.go

@@ -0,0 +1,16 @@
+package main
+
+import "fmt"
+
+func main() {
+	fmt.Println("")
+	fmt.Println("  Congratulations. You started successfully !")
+	fmt.Println("  You'll see, Go is simple and really slick.")
+	fmt.Println("")
+	fmt.Println("  Oh no! a typo -> icanhahz")
+	fmt.Println("")
+	fmt.Println("  Correct it and re-run this program.")
+	fmt.Println("")
+	fmt.Println("  You can modify this program by tweaking `main.go`")
+	fmt.Println("")
+}