DOC: bunch of docstring formatting fixes (sphinx warnings)

[jorisvandenbossche]

WIP towards getting sphinx doc build warning free

[codecov]

Codecov Report

Merging #26117 into master will decrease coverage by <.01%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##           master   #26117      +/-   ##
==========================================
- Coverage   91.99%   91.98%   -0.01%     
==========================================
  Files         175      175              
  Lines       52384    52384              
==========================================
- Hits        48189    48184       -5     
- Misses       4195     4200       +5

Flag	Coverage Δ
#multiple	90.53% <ø> (ø)	⬆️
#single	40.74% <ø> (-0.13%)	⬇️

Impacted Files	Coverage Δ
pandas/core/arrays/datetimelike.py	97.69% <ø> (ø)	⬆️
pandas/core/groupby/generic.py	89.02% <ø> (ø)	⬆️
pandas/core/series.py	93.67% <ø> (ø)	⬆️
pandas/core/frame.py	96.9% <ø> (-0.12%)	⬇️
pandas/core/arrays/datetimes.py	97.79% <ø> (ø)	⬆️
pandas/plotting/_core.py	83.76% <ø> (ø)	⬆️
pandas/core/window.py	96.39% <ø> (ø)	⬆️
pandas/io/parsers.py	95.84% <ø> (ø)	⬆️
pandas/io/gbq.py	75% <0%> (-12.5%)	⬇️
... and 1 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 68b1da7...e927e8b. Read the comment docs.

[codecov]

Codecov Report

Merging #26117 into master will decrease coverage by <.01%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##           master   #26117      +/-   ##
==========================================
- Coverage   91.99%   91.98%   -0.01%     
==========================================
  Files         175      175              
  Lines       52384    52384              
==========================================
- Hits        48189    48184       -5     
- Misses       4195     4200       +5

Flag	Coverage Δ
#multiple	90.53% <ø> (ø)	⬆️
#single	40.74% <ø> (-0.13%)	⬇️

Impacted Files	Coverage Δ
pandas/core/arrays/datetimelike.py	97.69% <ø> (ø)	⬆️
pandas/core/groupby/generic.py	89.02% <ø> (ø)	⬆️
pandas/core/series.py	93.67% <ø> (ø)	⬆️
pandas/core/frame.py	96.9% <ø> (-0.12%)	⬇️
pandas/core/arrays/datetimes.py	97.79% <ø> (ø)	⬆️
pandas/plotting/_core.py	83.76% <ø> (ø)	⬆️
pandas/core/window.py	96.39% <ø> (ø)	⬆️
pandas/io/parsers.py	95.84% <ø> (ø)	⬆️
pandas/io/gbq.py	75% <0%> (-12.5%)	⬇️
... and 1 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 68b1da7...e927e8b. Read the comment docs.

[jreback]

thanks @jorisvandenbossche