好的注释是一段简洁的说明加一段直观的样例代码，比如很多结构体上的注释会写这个结构体实现了什么接口，里面的方法如何使用。

从技术上目前通过解析go的语法树，只能看到注释是放在函数上的，需要额外的语法声明某个部分是用来描述参数。但是如果只是用来显示给别人看的话你完全可以用java的注释来描述go函数，没有问题的