DOC: Add docstring for Extensionarray interpolate

[ammar-qazi]

• DOC: Enforce Numpy Docstring Validation | pandas.api.extensions.ExtensionArray #58539

Fixed:

pandas.api.extensions.ExtensionArray.interpolate PR01,SA01

[mroeschke]

This docstring should not mention NumpyExtensionArray at all.

[ammar-qazi]

I've resolved this issue. Plus, I've also included example of FloatingArray to make the documentation more helpful for users.

[mroeschke]

Could you put this in it's own Raises section? Please review the numpydoc documentation for where a Raises section should be placed

[ammar-qazi]

I borrowed these insights from pandas.DataFrame.interpolate`. However, it appears that there's an issue with that documentation as well.

There's no method of ffill, bfill, or backfill. Besides that, the function fails in all cases if you use "pad."

For instance, even this raises a ValueError:

import pandas as pd
import numpy as np

# Create a sample DataFrame with NaN values
df = pd.DataFrame({
    'A': [1, 2, np.nan, np.nan, 5, 6]
})

print("Original DataFrame:")
print(df)

# Use interpolate with pad method
df_interpolated = df.interpolate(method='pad')

print("\nInterpolated DataFrame:")
print(df_interpolated)

[mroeschke]

Why did this example change?

[ammar-qazi]

I reverted the change.

[mroeschke]

Thanks @ammar-qazi