client: document MembersAPI/KeysAPI constructors

client/keys.go

@@ -39,10 +39,15 @@ var (
 	defaultV2KeysPrefix = "/v2/keys"
 )
 
+// NewKeysAPI builds a KeysAPI that interacts with etcd's key-value
+// API over HTTP.
 func NewKeysAPI(c Client) KeysAPI {
 	return NewKeysAPIWithPrefix(c, defaultV2KeysPrefix)
 }
 
+// NewKeysAPIWithPrefix acts like NewKeysAPI, but allows the caller
+// to provide a custom base URL path. This should only be used in
+// very rare cases.
 func NewKeysAPIWithPrefix(c Client, p string) KeysAPI {
 	return &httpKeysAPI{
 		client: c,

client/members.go

@@ -31,6 +31,8 @@ var (
 	defaultV2MembersPrefix = "/v2/members"
 )
 
+// NewMembersAPI constructs a new MembersAPI that uses HTTP to
+// interact with etcd's membership API.
 func NewMembersAPI(c Client) MembersAPI {
 	return &httpMembersAPI{
 		client: c,