From fd37d21849c58190d1b02109e6d8a4c71a79085e Mon Sep 17 00:00:00 2001
From: Ion Koutsouris <15728914+ion-elgreco@users.noreply.github.com>
Date: Tue, 2 Jan 2024 17:15:09 +0100
Subject: [PATCH 1/2] add missing

---
 docs/api/delta_table/delta_table_alterer.md | 11 +++++++++++
 mkdocs.yml                                  |  1 +
 python/deltalake/table.py                   | 11 ++++++++++-
 3 files changed, 22 insertions(+), 1 deletion(-)
 create mode 100644 docs/api/delta_table/delta_table_alterer.md

diff --git a/docs/api/delta_table/delta_table_alterer.md b/docs/api/delta_table/delta_table_alterer.md
new file mode 100644
index 0000000000..d859f605e1
--- /dev/null
+++ b/docs/api/delta_table/delta_table_alterer.md
@@ -0,0 +1,11 @@
+---
+search:
+  boost: 10
+---
+
+
+# TableAlterer
+
+::: deltalake.table.TableAlterer
+    options:
+        show_root_heading: true
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 4e713d73ec..a554378f4f 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -67,6 +67,7 @@ nav:
       - api/delta_table/metadata.md
       - api/delta_table/delta_table_merger.md
       - api/delta_table/delta_table_optimizer.md
+      - api/delta_table/delta_table_alterer.md
     - api/schema.md
     - api/storage.md
     - api/catalog.md
diff --git a/python/deltalake/table.py b/python/deltalake/table.py
index 5adeaaa9dc..3eaa456228 100644
--- a/python/deltalake/table.py
+++ b/python/deltalake/table.py
@@ -785,13 +785,22 @@ def update(
     def optimize(
         self,
     ) -> "TableOptimizer":
+        """Namespace for all table optimize related methods.
+        
+        Returns:
+            TableOptimizer: TableOptimizer Object
+        """
         return TableOptimizer(self)
 
     @property
     def alter(
         self,
     ) -> "TableAlterer":
-        """Namespace for all table alter related methods"""
+        """Namespace for all table alter related methods
+        
+        Returns:
+            TableAlterer: TableAlterer Object
+        """
         return TableAlterer(self)
 
     def merge(

From 76d6d08db48452e149aa082e7b376784411d2230 Mon Sep 17 00:00:00 2001
From: Ion Koutsouris <15728914+ion-elgreco@users.noreply.github.com>
Date: Tue, 2 Jan 2024 17:17:44 +0100
Subject: [PATCH 2/2] fmt

---
 python/deltalake/table.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/python/deltalake/table.py b/python/deltalake/table.py
index 0a04e264d2..4f93a6aa61 100644
--- a/python/deltalake/table.py
+++ b/python/deltalake/table.py
@@ -786,7 +786,7 @@ def optimize(
         self,
     ) -> "TableOptimizer":
         """Namespace for all table optimize related methods.
-        
+
         Returns:
             TableOptimizer: TableOptimizer Object
         """
@@ -796,8 +796,8 @@ def optimize(
     def alter(
         self,
     ) -> "TableAlterer":
-        """Namespace for all table alter related methods
-        
+        """Namespace for all table alter related methods.
+
         Returns:
             TableAlterer: TableAlterer Object
         """