DOC: Change doc template to fix SA04 errors in docstrings #28792
- [x] xref #28792

As requested in #32823 creating separate PR.
Also all descriptions for methods starts with upper case and it looks a little out of place. Should it be casted to lowercase perhaps?


cc @datapythonista  Thanks @dilex42. 

My preference would be, instead of just listing the reverse of each method (`add` <-> `radd`...), adding all the related methods in all docstrings:
```
See Also
--------
Series.add : ...
Series.radd : ...
Series.mul : ...
...
```
It'll be a bit long, but I don't think too much. I think all them are relevant for the users. And it'll reduce the complexity of that function, instead of increasing it.

I guess it makes sense to have two, one for comparisons, and one for algebra operations.

What do you think?
 I don't have experience to comment from designing perspective to what approach better.

I guess having all functions listed is reasonable. But if I understand correctly there will be 2 static templates, additional `type` param for each method and then some templates concatenation based on type so I don't know if it's gonna be less complex. Can't really tell without spending a decent amount of time where those docstrings are being used. I think for dataframe docstrings there are different templates, I thought it was the same for series. In that case my preferred option would be to have arithmetic and comparison methods all together in the See Also.

@WillAyd do you have an opinion here? The way I see it, we need to answer can we make it work with single flex template? If yes then sure let's do that. But if not then let's find the best solution with two templates. Is this description and formatting good? /azp run <samp>
Azure Pipelines successfully started running 1 pipeline(s).<br>

</samp> Thanks @dilex42 