Krzysiek/datatypes reference (#5442)

article on data types, a few adjustments in apidocs to include the type of elements that are stored in the column

GitOrigin-RevId: 3e7e93558b70ea1e6200b27053e41a127bed9292

python/pathway/internals/table.py

@@ -1969,7 +1969,7 @@ def sort(
         Args:
             table : pw.Table
                 The table to be sorted.
-            key : ColumnReference
+            key (ColumnExpression[int | float | datetime | str | bytes]):
                 An expression to sort by.
             instance : ColumnReference or None
                 An expression with instance. Rows are sorted within an instance.

python/pathway/stdlib/ordered/diff.py

@@ -17,10 +17,11 @@ def diff(
     according to the order defined by the column ``timestamp``.
 
     Args:
-        - ``timestamp`` (``ColumnReference``): The column reference to the ``timestamp`` column on
-            which the order is computed.
-        - ``*values`` (``ColumnReference``): Variable-length argument representing the column
-            references to the ``values`` columns.
+
+        - timestamp (pw.ColumnReference[int | float | datetime | str | bytes]):
+            The column reference to the ``timestamp`` column on which the order is computed.
+        - *values (pw.ColumnReference[int | float | datetime]):
+            Variable-length argument representing the column references to the ``values`` columns.
 
     Returns:
         ``Table``: A new table where each column is replaced with a new column containing

python/pathway/stdlib/temporal/_interval_join.py

@@ -596,8 +596,10 @@ def interval_join(
 
     Args:
         other:  the right side of a join.
-        self_time: time expression in self.
-        other_time: time expression in other.
+        self_time (pw.ColumnExpression[int | float | datetime]):
+            time expression in self.
+        other_time (pw.ColumnExpression[int | float | datetime]):
+            time expression in other.
         lower_bound: a lower bound on time difference between other_time
             and self_time.
         upper_bound: an upper bound on time difference between other_time

python/pathway/stdlib/temporal/_window.py

@@ -871,7 +871,7 @@ def windowby(
     optionally with `instance` argument.
 
     Args:
-        time_expr: Column expression used for windowing
+        time_expr (pw.ColumnExpression[int | float | datetime]): Column expression used for windowing
         window: type window to use
         instance: optional column expression to act as a shard key