diff --git a/auth_results.go b/auth_results.go
index de69d4a..856a233 100644
--- a/auth_results.go
+++ b/auth_results.go
@@ -2,9 +2,9 @@
 
 import "time"
 
-// AuthResults is a leftover type from the v0.x days. It was intended to
-// describe common functionality among identity service results, but is not
-// actually used anywhere.
+// AuthResults [deprecated] is a leftover type from the v0.x days. It was
+// intended to describe common functionality among identity service results, but
+// is not actually used anywhere.
 type AuthResults interface {
 	// TokenID returns the token's ID value from the authentication response.
 	TokenID() (string, error)
diff --git a/results.go b/results.go
index 7851d75..6585eba 100644
--- a/results.go
+++ b/results.go
@@ -6,7 +6,8 @@
 )
 
 /*
-Result is an internal type to be used by individual resource packages.
+Result is an internal type to be used by individual resource packages, but its
+methods will be available on a wide variety of user-facing embedding types.
 
 It acts as a base struct that other Result types, returned from request
 functions, can embed for convenience. All Results capture basic information
@@ -42,10 +43,15 @@
 	return string(pretty)
 }
 
-// ErrResult represents results that only contain a potential error and
+// ErrResult is an internal type to be used by individual resource packages, but
+// its methods will be available on a wide variety of user-facing embedding
+// types.
+//
+// It represents results that only contain a potential error and
 // nothing else. Usually, if the operation executed successfully, the Err field
 // will be nil; otherwise it will be stocked with a relevant error. Use the
-// ExtractErr method to cleanly pull it out.
+// ExtractErr method
+// to cleanly pull it out.
 type ErrResult struct {
 	Result
 }
@@ -56,7 +62,8 @@
 }
 
 /*
-HeaderResult is an internal type to be used by individual resource packages.
+HeaderResult is an internal type to be used by individual resource packages, but
+its methods will be available on a wide variety of user-facing embedding types.
 
 It represents a result that only contains an error (possibly nil) and an
 http.Header. This is used, for example, by the objectstorage packages in