Docs: More serializer documentation

body.go

@@ -43,6 +43,9 @@ func BodyBytes(b []byte) BodyGetter {
 	}
 }
 
+// BodySerializer is a BodyGetter
+// that uses the provided [Serializer]
+// to build the body of a request from v.
 func BodySerializer(s Serializer, v any) BodyGetter {
 	return func() (io.ReadCloser, error) {
 		b, err := s(v)
@@ -53,9 +56,8 @@ func BodySerializer(s Serializer, v any) BodyGetter {
 	}
 }
 
-// BodyJSON is a BodyGetter that marshals a JSON object.
-//
-// It uses [JSONSerializer] to marshal the object.
+// BodyJSON is a [BodySerializer]
+// that uses [JSONSerializer] to marshal the object.
 func BodyJSON(v any) BodyGetter {
 	return BodySerializer(JSONSerializer, v)
 }

builder_extras.go

@@ -133,6 +133,8 @@ func (rb *Builder) BodyBytes(b []byte) *Builder {
 	return rb.Body(BodyBytes(b))
 }
 
+// BodySerializer sets the Builder's request body
+// to the serialized object.
 func (rb *Builder) BodySerializer(s Serializer, v any) *Builder {
 	return rb.
 		Body(BodySerializer(s, v))
@@ -175,12 +177,14 @@ func (rb *Builder) CheckPeek(n int, f func([]byte) error) *Builder {
 	return rb.AddValidator(CheckPeek(n, f))
 }
 
+// ToDeserializer sets the Builder to decode a response into v
+// using a [Deserializer].
 func (rb *Builder) ToDeserializer(d Deserializer, v any) *Builder {
 	return rb.
 		Handle(ToDeserializer(d, v))
 }
 
-// ToJSON sets the Builder to decode a response as a JSON object
+// ToJSON sets the Builder to decode a response as a JSON object.
 //
 // It uses [JSONDeserializer] to unmarshal the object.
 func (rb *Builder) ToJSON(v any) *Builder {

handler.go

@@ -38,6 +38,7 @@ func consumeBody(res *http.Response) (err error) {
 	return err
 }
 
+// ToDeserializer decodes a response into v using a [Deserializer].
 func ToDeserializer(d Deserializer, v any) ResponseHandler {
 	return func(res *http.Response) error {
 		data, err := io.ReadAll(res.Body)