docs: apply recommendaded updates

* additionally, we log an erro in the case the redis client cannot shutdown in the scheduler

client.go

@@ -41,8 +41,8 @@ func NewClient(r RedisConnOpt) *Client {
 	return client
 }
 
-// NewClientFromRedisClient returns a new Client instance given a redis client.
+// NewClientFromRedisClient returns a new instance of Client given a redis.UniversalClient
-// Warning: the redis client will not be closed by Asynq, you are responsible for closing.
+// Warning: The underlying redis connection pool will not be closed by Asynq, you are responsible for closing it.
 func NewClientFromRedisClient(c redis.UniversalClient) *Client {
 	return &Client{broker: rdb.NewRDB(c), sharedConnection: true}
 }

inspector.go

@@ -36,8 +36,8 @@ func NewInspector(r RedisConnOpt) *Inspector {
 	return inspector
 }
 
-// NewFromRedisClient returns a new instance of Inspector.
+// NewInspectorFromRedisClient returns a new instance of Inspector given a redis.UniversalClient
-// Warning: the redis client will not be closed by Asynq, you are responsible for closing.
+// Warning: The underlying redis connection pool will not be closed by Asynq, you are responsible for closing it.
 func NewInspectorFromRedisClient(c redis.UniversalClient) *Inspector {
 	return &Inspector{
 		rdb:              rdb.NewRDB(c),

scheduler.go

@@ -60,9 +60,9 @@ func NewScheduler(r RedisConnOpt, opts *SchedulerOpts) *Scheduler {
 	return scheduler
 }
 
-// NewSchedulerFromRedisClient returns a new Scheduler instance given a redis client.
+// NewSchedulerFromRedisClient returns a new instance of Scheduler given a redis.UniversalClient
 // The parameter opts is optional, defaults will be used if opts is set to nil.
-// Warning: the redis client will not be closed by Asynq, you are responsible for closing.
+// Warning: The underlying redis connection pool will not be closed by Asynq, you are responsible for closing it.
 func NewSchedulerFromRedisClient(c redis.UniversalClient, opts *SchedulerOpts) *Scheduler {
 	if opts == nil {
 		opts = &SchedulerOpts{}
@@ -273,7 +273,9 @@ func (s *Scheduler) Shutdown() {
 	s.wg.Wait()
 
 	s.clearHistory()
-	s.client.Close()
+	if err := s.client.Close(); err != nil {
+		s.logger.Errorf("Failed to close redis client connection: %v", err)
+	}
 	if !s.sharedConnection {
 		s.rdb.Close()
 	}

server.go

@@ -440,9 +440,9 @@ func NewServer(r RedisConnOpt, cfg Config) *Server {
 	return server
 }
 
-// NewServerFromRedisClient returns a new Server given a redis client
+// NewServerFromRedisClient returns a new instance of Server given a redis.UniversalClient
-// and server configuration.
+// and server configuration
-// Warning: the redis client will not be closed by Asynq, you are responsible for closing.
+// Warning: The underlying redis connection pool will not be closed by Asynq, you are responsible for closing it.
 func NewServerFromRedisClient(c redis.UniversalClient, cfg Config) *Server {
 	baseCtxFn := cfg.BaseContext
 	if baseCtxFn == nil {