Add documentation to clarify if ResponseBody.close() is necessary

retrofit/src/main/java/retrofit2/Response.java

@@ -147,12 +147,22 @@ public boolean isSuccessful() {
     return rawResponse.isSuccessful();
   }
 
-  /** The deserialized response body of a {@linkplain #isSuccessful() successful} response. */
+  /**
+   * The deserialized response body of a {@linkplain #isSuccessful() successful} response.
+   *
+   * <p>If the body is of type {@link ResponseBody}, {@link ResponseBody#close()} must always be
+   * called to avoid leaking resources
+   */
   public @Nullable T body() {
     return body;
   }
 
-  /** The raw response body of an {@linkplain #isSuccessful() unsuccessful} response. */
+  /**
+   * The raw response body of an {@linkplain #isSuccessful() unsuccessful} response.
+   *
+   * <p>Calling {@link ResponseBody#close close} on the response body is unnecessary since it is
+   * closed internally by Retrofit.
+   */
   public @Nullable ResponseBody errorBody() {
     return errorBody;
   }