Merge pull request #111 from creachadair/example

Document how to serialize nodes to protobuf.

README.md

@@ -16,7 +16,7 @@ go get -u gopkg.in/bblfsh/client-go.v3/...
 ## Example
 ### CLI
 
-Allthough *clinet-go* is a library, this codebase also includes an example of `bblfsh-cli` application at [`./cmd/bblfsh-cli`](/cmd/bblfsh-cli). When [installed](#Installation), it allows to parse a single file, query it with XPath and print the resulting UAST structure immediatly. 
+Although *client-go* is a library, this codebase also includes an example of `bblfsh-cli` application at [`./cmd/bblfsh-cli`](/cmd/bblfsh-cli). When [installed](#Installation), it allows to parse a single file, query it with XPath and print the resulting UAST structure immediately.
 See `$ bblfsh-cli -h` for list of all available CLI options.
 
 ### Code
@@ -58,8 +58,19 @@ func main() {
 		nodeAr = append(nodeAr, it.Node().(nodes.Node))
 	}
 
-	//alternative: encode UAST nodes to JSON (instead of YAML example below)
-	//data, err := json.MarshalIndent(nodeAr, "", "  ")
+	// The example below emits YAML.
+	//
+	// Alternative 1: encode UAST nodes to JSON.
+	//   data, err := json.MarshalIndent(nodeAr, "", "  ")
+	//
+	// Alternative 2: encode UAST nodes to protobuf.
+	//   import "gopkg.in/bblfsh/sdk.v2/uast/nodes/nodesproto"
+	//   ...
+	//   for _, node := range nodesAr {
+	//      err := nodesproto.WriteTo(os.Stdout, nodeAr) // check
+	//      ...
+	//   }
+	//
 	data, err := uastyml.Marshal(nodeAr)
 	if err != nil {
 		panic(err)