Clarify some more internal/deprecated docs.
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