From 81863f2720a39313c68448c1fd68e07cc40e9498 Mon Sep 17 00:00:00 2001
From: Elton SV <16687349+el10savio@users.noreply.github.com>
Date: Thu, 4 Dec 2025 20:09:47 +0100
Subject: [PATCH 1/2] docs: Fix minor misspell in `cli.md`

Hi folks, big fan of Iceberg! I noticed a tiny change in the cli docs. Correcting it here
---
 mkdocs/docs/cli.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mkdocs/docs/cli.md b/mkdocs/docs/cli.md
index 984e0df43d..5bf72cd8c9 100644
--- a/mkdocs/docs/cli.md
+++ b/mkdocs/docs/cli.md
@@ -42,7 +42,7 @@ Options:
 --help                Show this message and exit.
 
 Commands:
-describe    Describes a namespace xor table
+describe    Describes a namespace or table
 drop        Operations to drop a namespace or table
 list        Lists tables or namespaces
 location    Returns the location of the table

From 77462c632323c384f32e07e55ca6de5b2fcad56e Mon Sep 17 00:00:00 2001
From: Elton SV <16687349+el10savio@users.noreply.github.com>
Date: Thu, 4 Dec 2025 21:22:13 +0100
Subject: [PATCH 2/2] Update cli.md

---
 mkdocs/docs/cli.md | 36 ++++++++++++++++++++----------------
 1 file changed, 20 insertions(+), 16 deletions(-)

diff --git a/mkdocs/docs/cli.md b/mkdocs/docs/cli.md
index 5bf72cd8c9..2fbac5e816 100644
--- a/mkdocs/docs/cli.md
+++ b/mkdocs/docs/cli.md
@@ -33,24 +33,28 @@ You can pass the path to the Catalog using the `--uri` and `--credential` argume
 Usage: pyiceberg [OPTIONS] COMMAND [ARGS]...
 
 Options:
---catalog TEXT
---verbose BOOLEAN
---output [text|json]
---ugi TEXT
---uri TEXT
---credential TEXT
---help                Show this message and exit.
+  --catalog TEXT
+  --verbose BOOLEAN
+  --output [text|json]
+  --ugi TEXT
+  --uri TEXT
+  --credential TEXT
+  --help                Show this message and exit.
 
 Commands:
-describe    Describes a namespace or table
-drop        Operations to drop a namespace or table
-list        Lists tables or namespaces
-location    Returns the location of the table
-properties  Properties on tables/namespaces
-rename      Renames a table
-schema      Gets the schema of the table
-spec        Returns the partition spec of the table
-uuid        Returns the UUID of the table
+  create      Operation to create a namespace.
+  describe    Describe a namespace or a table.
+  drop        Operations to drop a namespace or table.
+  files       List all the files of the table.
+  list        List tables or namespaces.
+  list-refs   List all the refs in the provided table.
+  location    Return the location of the table.
+  properties  Properties on tables/namespaces.
+  rename      Rename a table.
+  schema      Get the schema of the table.
+  spec        Return the partition spec of the table.
+  uuid        Return the UUID of the table.
+  version     Print pyiceberg version.
 ```
 
 This example assumes that you have a default catalog set. If you want to load another catalog, for example, the rest example above. Then you need to set `--catalog rest`.