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 {