chore: align docs and remove inline comments

Author: mridang

src/main/java/com/zitadel/TransportOptions.java

@@ -156,12 +156,10 @@ private SSLContext buildSSLContextInternal() throws GeneralSecurityException, IO
     private static final class InsecureTrustManager implements X509TrustManager {
         @Override
         public void checkClientTrusted(X509Certificate[] chain, String authType) {
-            // trust all
         }
 
         @Override
         public void checkServerTrusted(X509Certificate[] chain, String authType) {
-            // trust all
         }
 
         @Override

src/main/java/com/zitadel/Zitadel.java

@@ -227,7 +227,6 @@ public Zitadel(Authenticator authenticator) {
         this(
             authenticator,
             apiClient -> {
-                // Dummy lambda that does nothing, can add default behavior here if needed
             });
     }
 
@@ -236,7 +235,6 @@ public Zitadel(Authenticator authenticator, TransportOptions transportOptions) {
             authenticator,
             transportOptions,
             apiClient -> {
-                // Dummy lambda that does nothing, can add default behavior here if needed
             });
     }
 
@@ -331,11 +329,11 @@ public static Zitadel withAccessToken(String host, String accessToken) {
     }
 
     /**
-     * Initialize the SDK with a Personal Access Token (PAT) and custom transport options.
+     * Initialize the SDK with a Personal Access Token (PAT).
      *
      * @param host             API URL.
      * @param accessToken      Personal Access Token for Bearer authentication.
-     * @param transportOptions Transport options for HTTP connections.
+     * @param transportOptions Optional transport options for TLS, proxy, headers.
      * @return Configured Zitadel client instance.
      */
     public static Zitadel withAccessToken(String host, String accessToken, TransportOptions transportOptions) {
@@ -359,12 +357,12 @@ public static Zitadel withClientCredentials(String host, String clientId, String
     }
 
     /**
-     * Initialize the SDK using OAuth2 Client Credentials flow with custom transport options.
+     * Initialize the SDK using OAuth2 Client Credentials flow.
      *
      * @param host             API URL.
      * @param clientId         OAuth2 client identifier.
      * @param clientSecret     OAuth2 client secret.
-     * @param transportOptions Transport options for HTTP connections.
+     * @param transportOptions Optional transport options for TLS, proxy, headers.
      * @return Configured Zitadel client instance with token auto-refresh.
      */
     public static Zitadel withClientCredentials(String host, String clientId, String clientSecret, TransportOptions transportOptions) {
@@ -406,11 +404,11 @@ public static Zitadel withPrivateKey(String host, java.io.InputStream inputStrea
     }
 
     /**
-     * Initialize the SDK via Private Key JWT assertion with custom transport options.
+     * Initialize the SDK via Private Key JWT assertion.
      *
      * @param host             API URL.
      * @param keyFile          Path to service account JSON or PEM key file.
-     * @param transportOptions Transport options for HTTP connections.
+     * @param transportOptions Optional transport options for TLS, proxy, headers.
      * @return Configured Zitadel client instance using JWT assertion.
      */
     @SuppressFBWarnings({"PATH_TRAVERSAL_IN", "THROWS_METHOD_THROWS_RUNTIMEEXCEPTION"})
@@ -424,11 +422,11 @@ public static Zitadel withPrivateKey(String host, String keyFile, TransportOptio
     }
 
     /**
-     * Initialize the SDK via Private Key JWT assertion with custom transport options.
+     * Initialize the SDK via Private Key JWT assertion.
      *
      * @param host             API URL.
      * @param inputStream      Input stream containing service account JSON or PEM key data.
-     * @param transportOptions Transport options for HTTP connections.
+     * @param transportOptions Optional transport options for TLS, proxy, headers.
      * @return Configured Zitadel client instance using JWT assertion.
      */
     public static Zitadel withPrivateKey(String host, java.io.InputStream inputStream, TransportOptions transportOptions) {

src/test/java/com/zitadel/TransportOptionsTest.java

@@ -176,10 +176,8 @@ void testDefaultHeaders() throws Exception {
 
         assertNotNull(zitadel);
 
-        // Make an actual API call to verify headers propagate to service requests
         zitadel.getSettings().getGeneralSettings();
 
-        // Use WireMock's verification API to assert the header was sent on the API call
         URL verifyUrl = new URL("http://" + host + ":" + httpPort + "/__admin/requests/count");
         HttpURLConnection conn = (HttpURLConnection) verifyUrl.openConnection();
         conn.setRequestMethod("POST");
@@ -206,26 +204,13 @@ void testProxyUrl() throws Exception {
             .proxyUrl("http://" + host + ":" + proxyPort)
             .build();
 
-        // Use Docker-internal hostname — only resolvable through the proxy's network
         Zitadel zitadel = Zitadel.withAccessToken(
             "http://wiremock:8080", "test-token", options);
 
         assertNotNull(zitadel);
         zitadel.getSettings().getGeneralSettings();
     }
 
-    @Test
-    void testTransportOptionsObject() {
-        TransportOptions options = new TransportOptions.Builder()
-            .insecure(true)
-            .build();
-
-        Zitadel zitadel = Zitadel.withClientCredentials(
-            "https://" + host + ":" + httpsPort, "dummy-client", "dummy-secret", options);
-
-        assertNotNull(zitadel);
-    }
-
     @Test
     void testNoCaCertFails() {
         assertThrows(RuntimeException.class, () -> {