update docs

Author: razvan

docs/modules/trino/pages/usage-guide/client-spooling-protocol.adoc

@@ -0,0 +1,39 @@
+= Client Spooling Protocol
+:description: Enable and configure the Client Spooling Protocol in Trino for efficient handling of large result sets.
+:keywords: client spooling protocol, Trino, large result sets, memory management
+:trino-docs-spooling-url: https://trino.io/docs/476/client/client-protocol.html
+
+The Client Spooling Protocol in Trino is designed to efficiently handle large result sets. When enabled, this protocol allows the Trino server to spool results to external storage systems, reducing memory consumption and improving performance for queries that return large datasets.
+
+For more details, refer to the link:{trino-docs-spooling-url}[Trino documentation on Client Spooling Protocol {external-link-icon}^].
+
+== Configuration
+
+The client spooling protocol is disabled by default.
+To enable it, you need to set the `spec.clusterConfig.clientSpoolingProtocol` configuration property as shown below.
+
+[source,yaml]
+----
+spec:
+  clusterConfig:
+    clientSpoolingProtocol:
+      enabled: true # <1>
+      location: "s3://spooling-bucket/trino/" # <2>
+      filesystem:
+        s3: # <3>
+          connection:
+            reference: "minio"
+----
+<1> Enables the client spooling protocol
+<2> Specifies the location where spooled data will be stored. This example uses an S3 bucket.
+<3> Configures the filesystem type for spooling. Only S3 is supported currently via the custom resource definition.
+
+The operator automatically fills in additional settings required by Trino, such as the `protocol.spooling.shared-secret-key`.
+Users can change the contents of the `spooling-manager.properties` file by adding entries to the optional `spec.clusterConfig.clientSpoolingProtocol.config_overrides` map.
+
+[IMPORTANT]
+====
+Even if enabled, Trino may decide to not use the client spooling protocol for certain queries. Clients cannot force Trino to use it.
+====
+
+The clients need to have access to the same storage location configured for spooling.

docs/modules/trino/partials/nav.adoc

@@ -7,6 +7,7 @@
 ** xref:trino:usage-guide/listenerclass.adoc[]
 ** xref:trino:usage-guide/configuration.adoc[]
 ** xref:trino:usage-guide/fault-tolerant-execution.adoc[]
+** xref:trino:usage-guide/client-spooling-protocol.adoc[]
 ** xref:trino:usage-guide/s3.adoc[]
 ** xref:trino:usage-guide/security.adoc[]
 ** xref:trino:usage-guide/monitoring.adoc[]