GoDoc chose comment generated by protobuf as package documentation

[at15]

i.e.

• https://godoc.org/github.com/xephonhq/xephon-k/pkg/common
• https://godoc.org/github.com/xephonhq/xephon-k/pkg/storage/disk

So the fact is, godoc put all the top comments as package level comment, but code generated by protobuf use /* indent ... */ so it got highlighted. It's not a problem for normal usage of protobuf since they might be in a package of its own, while for xephon-k, we use struct generated by protobuf directly.

One solution is to automatically remove the comment and only keep the DO NOT EDIT. Btw: the DO NOT EDIT for generated double series is also shown in package level comment.

• remove protobuf comment
• remove DO NOT EDIT for double series in godoc (not in source code)
• add example (I think I have created a similar issue somewhere since golang support run in doc https://blog.golang.org/examples )

In general, current godoc is a mess ...

[at15]

Close in favor of #60

Should use a dedicated for protobuf generated package, i.e. xephonkpb