Example code should be in a *_test.go file, as per http://golang.org/doc/code.html#Testing and http://golang.org/pkg/testing/

Then running `go test` will catch out-of-dateness, subtle syntax errors, and other nice things.