DOC warn user about potential information loss in Resampler.interpolate
In scientific and technical domain people deal with high-frequent or non-equidistant timeseries. Using `resample("1s").interpolate()` can have unwanted side effects which we should warn in the documentation:

```python
import datetime as dt
import pandas as pd
import matplotlib.pyplot as plt

timesteps = [
    dt.datetime(2023, 3, 1, 7, 0, 0),
    dt.datetime(2023, 3, 1, 7, 0, 1),
    dt.datetime(2023, 3, 1, 7, 0, 2),
    dt.datetime(2023, 3, 1, 7, 0, 3),
    dt.datetime(2023, 3, 1, 7, 0, 4)
]
series = pd.Series(data=[1, -1, 2, 1, 3], index=timesteps)

resample_freq = "400ms"
series_resampler = series.resample(resample_freq)
series_resampled_linear = series_resampler.interpolate("linear")
```
which leads to the following:

![result](https://user-images.githubusercontent.com/12762439/227719356-b3974634-ae19-40cc-8e0a-7ad668da76c4.png)

For that example, information loss is expected.

Imho we should warn the user about this behavior. It seems to be known, to quote @jreback from [here](https://github.com/pandas-dev/pandas/issues/14297#issuecomment-285434729):

> so the reason this happens is because the index is first reindexed to the new time buckets (upsampled) via reindexing, then interpolation happens.  


- [x] refers to #12552, #14297
- [x] [Tests added and passed](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#writing-tests) if fixing a bug or adding a new feature
- [x] All [code checks passed](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#pre-commit).
- [x] Added [type annotations](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#type-hints) to new arguments/methods/functions.
- [ ] Added an entry in the latest `doc/source/whatsnew/vX.X.X.rst` file if fixing a bug or adding a new feature.

Thanks, looks like some of our docstring validations are failing @mroeschke let me know if something is missing/to be extended Thanks @kopytjuk 