docs: update Javadoc with preferred Deadline approach.

Author: karel-rehor

src/main/java/com/influxdb/v3/client/internal/GrpcCallOptions.java

@@ -21,6 +21,7 @@
  */
 package com.influxdb.v3.client.internal;
 
+import java.time.Duration;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
@@ -226,6 +227,11 @@ public Builder() {
         /**
          * Sets the absolute deadline for a rpc call.
          *
+         * <p><i>Please note</i> the preferred approach is to set a <code>queryTimeout</code>
+         * Duration value globally in the ClientConfig
+         * ({@link com.influxdb.v3.client.config.ClientConfig.Builder#queryTimeout(Duration)}).
+         * This value will then be used to calculate a new Deadline with each call.</p>
+         *
          * @param deadline The deadline
          * @return this
          */