Improved docstring offset class BusinessDay

Author: Sebastian Goldmann

pandas/_libs/tslibs/offsets.pyx

@@ -1899,6 +1899,9 @@ cdef class BusinessDay(BusinessMixin):
     """
     DateOffset subclass representing possibly n business days.
 
+    This offset is commonly used in financial and business contexts where weekends
+    and holidays are excluded from date calculations. 
+
     Parameters
     ----------
     n : int, default 1
@@ -1908,6 +1911,16 @@ cdef class BusinessDay(BusinessMixin):
     offset : timedelta, default timedelta(0)
         Time offset to apply.
 
+    Returns
+    -------
+    BusinessDay
+        A business day offset instance.
+
+    See Also
+    --------
+    CustomBusinessDay : A business day offset with custom holidays and weekmask.
+    DateOffset : The base class for all time-based offsets.
+
     Examples
     --------
     You can use the parameter ``n`` to represent a shift of n business days.
@@ -1925,6 +1938,7 @@ cdef class BusinessDay(BusinessMixin):
     >>> ts + pd.offsets.BusinessDay(normalize=True)
     Timestamp('2022-12-12 00:00:00')
     """
+
     _period_dtype_code = PeriodDtypeCode.B
     _prefix = "B"
     _attributes = tuple(["n", "normalize", "offset"])