Comments from Arthur and Joe

_toc.yml

@@ -815,7 +815,7 @@ entries:
             title: Supported table engines
           - file: docs/products/clickhouse/reference/metrics-list
             title: ClickHouse metrics in Grafana
-          - file: docs/products/clickhouse/reference/table-functions
+          - file: docs/products/clickhouse/reference/supported-table-functions
             title: Table functions
           - file: docs/products/clickhouse/reference/s3-supported-file-formats
             title: S3 file formats

docs/products/clickhouse/reference/s3-supported-file-formats.rst

@@ -13,5 +13,5 @@ The `S3 table function <https://clickhouse.com/docs/en/sql-reference/table-funct
 
 .. seealso::
 
-    * :doc:`Table functions supported in Aiven for ClickHouse® </docs/products/clickhouse/reference/table-functions>`
+    * :doc:`Table functions supported in Aiven for ClickHouse® </docs/products/clickhouse/reference/supported-table-functions>`
     * :doc:`Read and pull data from S3 object storages and web resources over HTTP </docs/products/clickhouse/howto/run-federated-queries>`

docs/products/clickhouse/reference/table-functions.rst → docs/products/clickhouse/reference/supported-table-functions.rst

@@ -1,7 +1,14 @@
 Table functions supported in Aiven for ClickHouse®
 ==================================================
 
-Table functions return data of the table type and are used to construct tables. Aiven for ClickHouse® supports the following `table functions <https://clickhouse.com/docs/en/sql-reference/table-functions>`_:
+`Table functions <https://clickhouse.com/docs/en/sql-reference/table-functions>`_ can be used to construct tables, for example, in a `FROM` clause of a query or in an `INSERT INTO TABLE FUNCTION` statement.
+
+.. code-block:: bash
+
+   SELECT *
+   FROM deltaLake('s3://bucket/path/to/lake')
+
+Aiven for ClickHouse® supports the following table functions:
 
 * ``cluster``
 * ``clusterAllReplicas``