Repository: ibis-project/ibis

Issue:
bug: .epoch_seconds() doesn't show up in docs
### What happened?

title; there is a docstring but it's not discoverable in documentation (other than mention in release notes)

### What version of ibis are you using?

latest

### What backend(s) are you using, if any?

n/a

### Relevant log output

_No response_

### Code of Conduct

- [X] I agree to follow this project's Code of Conduct


Discussion:
This is, I believe, part of a larger issue where `mkdocstrings` cannot display docstrings for methods/attributes/properties that are inherited (and `epoch_seconds` and others are part of the `_DateComponentMixin`)

Resolving patch:
diff --git a/ibis/expr/types/temporal.py b/ibis/expr/types/temporal.py
--- a/ibis/expr/types/temporal.py
+++ b/ibis/expr/types/temporal.py
@@ -207,6 +207,17 @@ def __add__(
         return _binop(ops.TimeAdd, self, other)
 
     add = radd = __radd__ = __add__
+    """Add an interval to a time expression.
+
+    Parameters
+    ----------
+    other : datetime.timedelta | pd.Timedelta | IntervalValue
+        Interval to add to time expression
+
+    Returns
+    -------
+    Value : TimeValue | NotImplemented
+    """
 
     def __sub__(
         self,
@@ -225,6 +236,17 @@ def __sub__(
         return _binop(op, self, other)
 
     sub = __sub__
+    """Subtract a time or an interval from a time expression.
+
+    Parameters
+    ----------
+    other : TimeValue | IntervalValue
+        Interval to subtract from time expression
+
+    Returns
+    -------
+    Value : IntervalValue | TimeValue | NotImplemented
+    """
 
     def __rsub__(
         self,
@@ -280,6 +302,17 @@ def __add__(
         return _binop(ops.DateAdd, self, other)
 
     add = radd = __radd__ = __add__
+    """Add an interval to a date.
+
+    Parameters
+    ----------
+    other : datetime.timedelta | pd.Timedelta | IntervalValue
+        Interval to add to DateValue
+
+    Returns
+    -------
+    Value : DateValue | NotImplemented
+    """
 
     def __sub__(
         self,
@@ -302,6 +335,17 @@ def __sub__(
         return _binop(op, self, other)
 
     sub = __sub__
+    """Subtract a date or an interval from a date.
+
+    Parameters
+    ----------
+    other : datetime.date | DateValue | datetime.timedelta | pd.Timedelta | IntervalValue
+        Interval to subtract from DateValue
+
+    Returns
+    -------
+    Value : DateValue | NotImplemented
+    """
 
     def __rsub__(
         self,
@@ -374,6 +418,17 @@ def __add__(
         return _binop(ops.TimestampAdd, self, other)
 
     add = radd = __radd__ = __add__
+    """Add an interval to a timestamp.
+
+    Parameters
+    ----------
+    other : datetime.timedelta | pd.Timedelta | IntervalValue
+        Interval to subtract from timestamp
+
+    Returns
+    -------
+    Value : TimestampValue | NotImplemented
+    """
 
     def __sub__(
         self,
@@ -397,6 +452,17 @@ def __sub__(
         return _binop(op, self, other)
 
     sub = __sub__
+    """Subtract a timestamp or an interval from a timestamp.
+
+    Parameters
+    ----------
+    other : datetime.datetime | pd.Timestamp | TimestampValue | datetime.timedelta | pd.Timedelta | IntervalValue
+        Timestamp or interval to subtract from timestamp
+
+    Returns
+    -------
+    Value : IntervalValue | TimestampValue | NotImplemented
+    """
 
     def __rsub__(
         self,


Test patch: