From e8c02ab2419043616e6aa5ece17a9019b6fa549e Mon Sep 17 00:00:00 2001 From: Mark McGranaghan Date: Tue, 18 Sep 2012 20:23:32 -0700 Subject: [PATCH] words --- blog/getting-started-with-go.md | 48 ++++++++++++++++++++ blog/go-by-example-json.md | 3 -- blog/go-on-heroku.md | 1 + blog/go-package-versioning-and-management.md | 19 ++++++-- www/index.md | 30 ++++++++++++ 5 files changed, 95 insertions(+), 6 deletions(-) create mode 100644 blog/getting-started-with-go.md delete mode 100644 blog/go-by-example-json.md create mode 100644 www/index.md diff --git a/blog/getting-started-with-go.md b/blog/getting-started-with-go.md new file mode 100644 index 0000000..eb77d72 --- /dev/null +++ b/blog/getting-started-with-go.md @@ -0,0 +1,48 @@ +https://gist.github.com/4984b5d9fe9244776197 + +## Getting Started with Go and Heroku + +This is an quick guide to getting started with Go. It's for experienced +programers interested in Go, and assumes you are familiar with the +terminal are using a modern Mac. It +covers everything you need to know from the [Go setup doc](http://golang.org/doc/install) +and provides additional context about environment variables and +code layouts that will help you avoid confusion. + + +### Download and Install Go + +Go to the [downloads page](http://code.google.com/p/go/downloads/list) +and choose the link for your OS. Click on the downloaded package and +follow the quick installer. + +To test your install, open a new Terminal window and try the `go` +command: + + $ go version + go version go1.0.2 + + +### Hello World + +Here is a simple Go program. Put this in `hello.go`: + + package main + + import "fmt" + + func main() { + fmt.Printf("hello, world\n") + } + +Now try it with `go run`: + + $ go run hello.go + Hello, world + +Great, it worked! + + +### Set up Go Workspace and Environment + +Go expects a few particular things to be configured. diff --git a/blog/go-by-example-json.md b/blog/go-by-example-json.md deleted file mode 100644 index 0fbfb83..0000000 --- a/blog/go-by-example-json.md +++ /dev/null @@ -1,3 +0,0 @@ -very common: fetch json document, parse into in-memory data structure - -how this can be not terrible diff --git a/blog/go-on-heroku.md b/blog/go-on-heroku.md index bacecf9..dbf562d 100644 --- a/blog/go-on-heroku.md +++ b/blog/go-on-heroku.md @@ -2,6 +2,7 @@ Base on quickstart. + #### Calls to Action ... diff --git a/blog/go-package-versioning-and-management.md b/blog/go-package-versioning-and-management.md index a5d1714..0c554bb 100644 --- a/blog/go-package-versioning-and-management.md +++ b/blog/go-package-versioning-and-management.md @@ -1,6 +1,19 @@ -## Go Package Versioning and Management +## Go Package Versioning -Trick question. +If you're new to Go you'll probably ask yourself the question: + + How does Go do package versioning? + +The short answer is: it doesn't. But don't panic! There is a good +reason for this approach. + +In this post we explain why Go takes this approach and what it means +for you as a go package user and package author. + + +### Always Ship Master + +* Do not change public APIs. @@ -8,6 +21,6 @@ The vendored option. Every major programming language has evolved. -#### Call to Action +#### Learn More About Go Want to learn more about go. [Go by Example]() will teach you! diff --git a/www/index.md b/www/index.md new file mode 100644 index 0000000..b34a326 --- /dev/null +++ b/www/index.md @@ -0,0 +1,30 @@ +## Go by Example + +** + +_Go by Example_ is a practical guide to the Go programming language. +consisting of more than a hundred complete Go programs. The book +covers everything from getting started to writing sophisticated +concurrent programs. + + + +You'll learn the basic of Go and how to build real-world programs +like database-backed web sites. + +Condense all Google queries. + +#### About the Author + +Mark McGranaghan is an engineer, technical designer, and developer +product enthusiast. Contact him at mmcgrana@gmail.com + +---------------- + +(c) 2012 Mark McGranaghan + +* Working examples +* N examples +* Web, SQL, JSON +* Upcoming +* Fast