DOC - rewording two docstrings

Author: rcap107

skrub/_string_encoder.py

@@ -17,8 +17,7 @@
 
 
 class StringEncoder(TransformerMixin, SingleColumnTransformer):
-    """Encode string features by using tf-idf vectorization and truncated singular \
-    value decomposition (SVD).
+    """Encode string columns as a numeric array using Latent Semantic Analysis (LSA).
 
     First, apply a tf-idf vectorization of the text, then reduce the dimensionality
     with a truncated SVD with the given number of parameters.

skrub/_to_datetime.py

@@ -487,7 +487,15 @@ def _guess_datetime_format(column):
 
 
 def to_datetime(data, format=None):
-    """Convert DataFrame or column to Datetime dtype.
+    """Convert a dataframe or series to Datetime dtype.
+
+    This function tries to convert the given dataframe or series from string to datetime,
+    by either testing common datetime formats or using the ``format`` specified
+    by the user. Columns that cannot be parsed are returned unchanged.
+
+    Note that this transformation is stateless, so it should not be used in a
+    pipeline that is fitted on a training set and then applied to a test set.
+    Use the :class:`ToDatetime` transformer instead.
 
     .. caution ::
 
@@ -499,7 +507,7 @@ def to_datetime(data, format=None):
     Parameters
     ----------
     data : pandas or polars ``{DataFrame, Series}``
-        The dataframe or series to transform.
+        The dataframe or series to convert to Datetime.
 
     format : str or None, optional, default=None
         Format string to use to parse datetime strings.