From e3d0069a47745ada390b7f9f021a9fae69bf1bbd Mon Sep 17 00:00:00 2001
From: Dorota Wojcik <dorota.wojcik@aiven.io>
Date: Fri, 6 Oct 2023 12:57:34 +0200
Subject: [PATCH] Comments from Arthur and Joe

---
 _toc.yml                                                 | 2 +-
 .../clickhouse/reference/s3-supported-file-formats.rst   | 2 +-
 ...table-functions.rst => supported-table-functions.rst} | 9 ++++++++-
 3 files changed, 10 insertions(+), 3 deletions(-)
 rename docs/products/clickhouse/reference/{table-functions.rst => supported-table-functions.rst} (57%)

diff --git a/_toc.yml b/_toc.yml
index 68728347e2..47afc43008 100644
--- a/_toc.yml
+++ b/_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
diff --git a/docs/products/clickhouse/reference/s3-supported-file-formats.rst b/docs/products/clickhouse/reference/s3-supported-file-formats.rst
index f59a66118e..690580e244 100644
--- a/docs/products/clickhouse/reference/s3-supported-file-formats.rst
+++ b/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>`
diff --git a/docs/products/clickhouse/reference/table-functions.rst b/docs/products/clickhouse/reference/supported-table-functions.rst
similarity index 57%
rename from docs/products/clickhouse/reference/table-functions.rst
rename to docs/products/clickhouse/reference/supported-table-functions.rst
index e6b1f06650..7b4b760038 100644
--- a/docs/products/clickhouse/reference/table-functions.rst
+++ b/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``