From 584283c077a44e6ea4738c3df4ebdafc473125b9 Mon Sep 17 00:00:00 2001
From: Juan Calderon-Perez <835733+gaby@users.noreply.github.com>
Date: Fri, 13 Dec 2024 07:24:36 -0500
Subject: [PATCH] Update inline docs

---
 client/client.go  | 5 ++++-
 client/request.go | 1 +
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/client/client.go b/client/client.go
index fc9171c8ab..456eac20a8 100644
--- a/client/client.go
+++ b/client/client.go
@@ -283,7 +283,9 @@ func (c *Client) AddHeaders(h map[string][]string) *Client {
 	return c
 }
 
-// SetHeaders sets multiple header fields and their values in the client.
+// SetHeaders method sets multiple headers field and its values at one go in the client instance.
+// These headers will be applied to all requests created from this client instance. Also it can be
+// overridden at request level headers options.
 func (c *Client) SetHeaders(h map[string]string) *Client {
 	c.header.SetHeaders(h)
 	return c
@@ -301,6 +303,7 @@ func (c *Client) Param(key string) []string {
 }
 
 // AddParam adds a single query parameter and its value to the client.
+// These params will be applied to all requests created from this client instance.
 func (c *Client) AddParam(key, val string) *Client {
 	c.params.Add(key, val)
 	return c
diff --git a/client/request.go b/client/request.go
index ede9670d62..6c54fe7a6d 100644
--- a/client/request.go
+++ b/client/request.go
@@ -116,6 +116,7 @@ func (r *Request) Context() context.Context {
 }
 
 // SetContext sets the context for the Request, allowing request cancellation if ctx is done.
+// See https://blog.golang.org/context article and the "context" package documentation.
 func (r *Request) SetContext(ctx context.Context) *Request {
 	r.ctx = ctx
 	return r