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}, calling {@link ResponseBody#close close} is
+ * unnecessary unless the Retrofit call was annotated with {@link retrofit2.http.Streaming @Streaming}
+ */
  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;
  }