diff --git a/net/client.go b/net/client.go
index e1b919e46c8003f62558c0d67b08a9cddf8cba8c..ebbce6237acb9cf5318f1eb99c9aa7e726551dec 100644
--- a/net/client.go
+++ b/net/client.go
@@ -12,8 +12,8 @@ import (
 
 // Connect to a peer.
 //
-// Given parameters cert/key/ca are PEM-encoded array of byte
-// Closing must be defered after call
+// Given parameters cert/key/ca are PEM-encoded array of bytes.
+// Closing must be defered after call.
 func Connect(addrPort string, cert, key, ca []byte) *grpc.ClientConn {
 	// load peer cert/key, ca as PEM buffers
 	peerCert, err := tls.X509KeyPair(cert, key)
diff --git a/net/server.go b/net/server.go
index e2b4e6af1651dceca46109b84b706d3a6c51171f..dca1611f393e1a50fb7ab7272d790440da7cb5a1 100644
--- a/net/server.go
+++ b/net/server.go
@@ -11,12 +11,12 @@ import (
 	"google.golang.org/grpc/grpclog"
 )
 
-// NewServer create a new grpc server with given tls credentials.
+// NewServer creates a new grpc server with given tls credentials.
 //
-// cert/key/ca are PEM-encoded array of byte
+// cert/key/ca are PEM-encoded array of bytes.
 //
 // The returned grpcServer must be used in association with server{} to
-// register APIs before calling Listen()
+// register APIs before calling Listen().
 func NewServer(cert, key, ca []byte) *grpc.Server {
 	// configure gRPC
 	var opts []grpc.ServerOption
@@ -42,9 +42,7 @@ func NewServer(cert, key, ca []byte) *grpc.Server {
 
 // Listen with specified server on addr:port.
 //
-// addrPort is formated as 127.0.0.1:8001
-// * addr is the addr to bind to,
-// * port is the port to listen on
+// addrPort is formated as 127.0.0.1:8001.
 func Listen(addrPort string, grpcServer *grpc.Server) {
 	// open tcp socket
 	lis, err := net.Listen("tcp", addrPort)