A second read on the wording there.
diff --git a/params.go b/params.go
index 12f894c..7b79166 100644
--- a/params.go
+++ b/params.go
@@ -15,8 +15,8 @@
It takes a string that might be a zero value and returns either a pointer to its
address or nil. This is useful for allowing users to conveniently omit values
-from an options struct, but still pass nil to the JSON serializer to omit them
-from a request body.
+from an options struct by leaving them zeroed, but still pass nil to the JSON
+serializer so they'll be omitted from the request body.
*/
func MaybeString(original string) *string {
if original != "" {
@@ -29,9 +29,9 @@
MaybeInt is an internal function to be used by request methods in individual
resource packages.
-Like MaybeString, it accepts an int that may be a zero value and returns either
-a pointer to its address or nil to hint to the JSON serializer to omit its
-field.
+Like MaybeString, it accepts an int that may or may not be a zero value, and
+returns either a pointer to its address or nil. It's intended to hint that the
+JSON serializer should omit its field.
*/
func MaybeInt(original int) *int {
if original != 0 {