remove loc

Author: MarcoGorelli

spec/API_specification/dataframe_api/dataframe_object.py

@@ -209,9 +209,9 @@ def insert_column(self, column: Column[Any]) -> DataFrame:
         """
         ...
 
-    def insert_columns(self, locs_and_columns: Sequence[tuple[int, Column[Any]]]) -> DataFrame:
+    def insert_columns(self, columns: Sequence[Column[Any]]) -> DataFrame:
         """
-        Insert columns into DataFrame at specified locations.
+        Insert columns into DataFrame at rightmost location.
 
         Like :meth:`insert_column`, but can insert multiple (independent) columns.
         Some implementations may be able to make use of parallelism in this
@@ -220,9 +220,9 @@ def insert_columns(self, locs_and_columns: Sequence[tuple[int, Column[Any]]]) ->
         .. code-block::
 
             new_column = df.get_column_by_name('a') + 1
-            df = df.insert_column(0, new_column.rename('a_plus_1'))
+            df = df.insert_column(new_column.rename('a_plus_1'))
             new_column = df.get_column_by_name('b') + 1
-            df = df.insert_column(1, new_column.rename('b_plus_1'))
+            df = df.insert_column(new_column.rename('b_plus_1'))
         
         it would be better to write
 
@@ -232,21 +232,21 @@ def insert_columns(self, locs_and_columns: Sequence[tuple[int, Column[Any]]]) ->
             new_column_1 = df.get_column_by_name('b') + 1
             df = df.insert_columns(
                 [
-                    (0, new_column_0.rename('a_plus_1')),
-                    (1, new_column_1.rename('b_plus_1')),
+                    new_column_0.rename('a_plus_1'),
+                    new_column_1.rename('b_plus_1'),
                 ]
             )
         
         so that insertion can happen in parallel for some implementations.
 
         Parameters
         ----------
-        locs_and_columns : Sequence[Tuple[int, Column]]
-            Sequence of tuples of the kind (location, column).
+        columns : Sequence[Column]
+            Sequence of `Column`s.
             Must be independent of each other.
-            Locations and column names must be unique.
+            Column names must be unique.
             Column names may not already be present in the
-            dataframe - use `DataFrame.rename` to rename them
+            dataframe - use :meth:`Column.rename` to rename them
             beforehand if necessary.
         
         Returns