docs: infer_datetime_format() deprecated

Author: Shashwat

doc/source/user_guide/io.rst

@@ -275,6 +275,14 @@ parse_dates : boolean or list of ints or names or list of lists or dict, default
 infer_datetime_format : boolean, default ``False``
   If ``True`` and parse_dates is enabled for a column, attempt to infer the
   datetime format to speed up the processing.
+
+  .. deprecated:: 1.5.2
+   ``infer_datetime_format`` be deprecated (as a strict version of it will become the default);
+    an easy workaround for non-strict parsing be clearly documented.
+
+   Currently, the only way to ensure consistent parsing is by explicitly passing
+   ``format=``. The argument ``infer_datetime_format``
+   isn't strict, can be called together with ``format``, and can still break users' expectations:
 keep_date_col : boolean, default ``False``
   If ``True`` and parse_dates specifies combining multiple columns then keep the
   original columns.
@@ -916,12 +924,10 @@ an exception is raised, the next one is tried:
 
 Note that performance-wise, you should try these methods of parsing dates in order:
 
-1. Try to infer the format using ``infer_datetime_format=True`` (see section below).
-
-2. If you know the format, use ``pd.to_datetime()``:
+1. If you know the format, use ``pd.to_datetime()``:
    ``date_parser=lambda x: pd.to_datetime(x, format=...)``.
 
-3. If you have a really non-standard format, use a custom ``date_parser`` function.
+2. If you have a really non-standard format, use a custom ``date_parser`` function.
    For optimal performance, this should be vectorized, i.e., it should accept arrays
    as arguments.