From 46e86ce4fdffc2933e15fd2f058df79f9538cd62 Mon Sep 17 00:00:00 2001
From: MarcoGorelli <33491632+MarcoGorelli@users.noreply.github.com>
Date: Sat, 26 Aug 2023 14:24:53 +0200
Subject: [PATCH 1/2] remove loc from insert_column

---
 .../dataframe_api/dataframe_object.py         | 24 ++++++++++++-------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/spec/API_specification/dataframe_api/dataframe_object.py b/spec/API_specification/dataframe_api/dataframe_object.py
index cd109a7e..ca703516 100644
--- a/spec/API_specification/dataframe_api/dataframe_object.py
+++ b/spec/API_specification/dataframe_api/dataframe_object.py
@@ -180,23 +180,31 @@ def get_rows_by_mask(self, mask: Column[Bool]) -> DataFrame:
         """
         ...
 
-    def insert_column(self, loc: int, column: Column[Any]) -> DataFrame:
+    def insert_column(self, column: Column[Any]) -> DataFrame:
         """
-        Insert column into DataFrame at specified location.
+        Insert column into DataFrame at rightmost location.
 
         The column's name will be used as the label in the resulting dataframe.
         To insert the column with a different name, combine with `Column.rename`,
         e.g.:
 
-        .. code-block :: python
+        .. code-block:: python
 
             new_column = df.get_column_by_name('a') + 1
-            df = df.insert(0, new_column.rename('a_plus_1'))
+            df = df.insert(new_column.rename('a_plus_1'))
+        
+        If you need to insert the column at a different location, combine with
+        :meth:`get_columns_by_name`, e.g.:
+
+        .. code-block:: python
+
+            new_column = df.get_column_by_name('a') + 1
+            new_columns_names = ['a_plus_1'] + df.get_column_names()
+            df = df.insert(new_column.rename('a_plus_1'))
+            df = df.get_columns_by_name(new_column_names)
 
         Parameters
         ----------
-        loc : int
-            Insertion index. Must verify 0 <= loc <= len(columns).
         column : Column
         """
         ...
@@ -235,13 +243,13 @@ def rename_columns(self, mapping: Mapping[str, str]) -> DataFrame:
         """
         ...
 
-    def get_column_names(self) -> Sequence[str]:
+    def get_column_names(self) -> list[str]:
         """
         Get column names.
 
         Returns
         -------
-        Sequence[str]
+        list[str]
         """
         ...
     

From bd9c77be90ba2e515bf319aa217d9dbf188aa7a5 Mon Sep 17 00:00:00 2001
From: MarcoGorelli <33491632+MarcoGorelli@users.noreply.github.com>
Date: Sat, 26 Aug 2023 14:49:23 +0200
Subject: [PATCH 2/2] fix outdated example

---
 spec/API_specification/dataframe_api/dataframe_object.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/spec/API_specification/dataframe_api/dataframe_object.py b/spec/API_specification/dataframe_api/dataframe_object.py
index ca703516..934ab731 100644
--- a/spec/API_specification/dataframe_api/dataframe_object.py
+++ b/spec/API_specification/dataframe_api/dataframe_object.py
@@ -191,7 +191,7 @@ def insert_column(self, column: Column[Any]) -> DataFrame:
         .. code-block:: python
 
             new_column = df.get_column_by_name('a') + 1
-            df = df.insert(new_column.rename('a_plus_1'))
+            df = df.insert_column(new_column.rename('a_plus_1'))
         
         If you need to insert the column at a different location, combine with
         :meth:`get_columns_by_name`, e.g.:
@@ -200,7 +200,7 @@ def insert_column(self, column: Column[Any]) -> DataFrame:
 
             new_column = df.get_column_by_name('a') + 1
             new_columns_names = ['a_plus_1'] + df.get_column_names()
-            df = df.insert(new_column.rename('a_plus_1'))
+            df = df.insert_column(new_column.rename('a_plus_1'))
             df = df.get_columns_by_name(new_column_names)
 
         Parameters