Improved documentation for Protocol::HTTP::Response.

Author: ioquatix

lib/protocol/http/response.rb

@@ -151,6 +151,9 @@ def self.for_exception(exception)
 				Response[500, Headers["content-type" => "text/plain"], ["#{exception.class}: #{exception.message}"]]
 			end
 
+			# Convert the response to a hash suitable for serialization.
+			#
+			# @returns [Hash] The response as a hash.
 			def as_json(...)
 				{
 					version: @version,
@@ -161,14 +164,23 @@ def as_json(...)
 				}
 			end
 
+			# Convert the response to JSON.
+			#
+			# @returns [String] The response as JSON.
 			def to_json(...)
 				as_json.to_json(...)
 			end
 
+			# Summarise the response as a string.
+			#
+			# @returns [String] The response as a string.
 			def to_s
 				"#{@status} #{@version}"
 			end
 
+			# Implicit conversion to an array.
+			#
+			# @returns [Array] The response as an array, e.g. `[status, headers, body]`.
 			def to_ary
 				return @status, @headers, @body
 			end