DOC: Formatting of generated DataFrame method docstrings
- [ ] closes #xxxx (Replace xxxx with the GitHub issue number)
- [ ] [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
- [ ] All [code checks passed](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#pre-commit).
- [ ] 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.


My initial motivation for this was to improve the readability and appearance of this sentence in the docs. The capital letter in the middle of the sentence looked like it could be a typo when I first read it.

https://pandas.pydata.org/docs/dev/reference/api/pandas.DataFrame.le.html
<img width="628" alt="image" src="https://user-images.githubusercontent.com/122238526/216797977-e6fe2f93-1aba-48df-a28c-6f8820c0110d.png">


This pull request improves it (in my opinion), making it look like this instead:

<img width="633" alt="image" src="https://user-images.githubusercontent.com/122238526/216798026-3de49a5b-2258-473c-ba8c-95eadf41456c.png">

This is one of a family of docstrings that is generated, so they are all affected by my change.  For consistency I made the change for both the comparison and equivalence operators.  

I think in the case of a operator that is multiple words ('less than or equal to') the italics improve readability.  However, if we look at an operator that is only one word ('subtract') the capital letter is still gone, but the italics probably don't contribute to readability (but don't do any harm either).  Before/after my change shown below.

<img width="628" alt="image" src="https://user-images.githubusercontent.com/122238526/216798166-7964717b-f1b8-4edf-bed3-66b506832dab.png">

<img width="608" alt="image" src="https://user-images.githubusercontent.com/122238526/216798195-41bd0cc4-b041-4d87-9ebb-d1c671e782b0.png">


Putting this out there as an idea more than anything - I think this improves readability but would like to hear what others think. Thanks!




This pull request is stale because it has been open for thirty days with no activity. Please [update](https://pandas.pydata.org/pandas-docs/stable/development/contributing.html#updating-your-pull-request) and respond to this comment if you're still interested in working on this. Thanks for the pull request, but it appears to have gone stale. If interested in continuing, please merge in the main branch, address any review comments and/or failing tests, and we can reopen.