DOC: Fixing test and validate docstrings for section ordering
- [x] closes ##23133
- [x] tests added / passed
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`

Hello @ryankarlos! Thanks for submitting the PR.

 - There are no PEP8 issues in the file [`scripts/tests/test_validate_docstrings.py`](https://github.com/ryankarlos/pandas/blob/2e7c6d17753711fcc0fdeff059fa7c6393dca534/scripts/tests/test_validate_docstrings.py) !

 - There are no PEP8 issues in the file [`scripts/validate_docstrings.py`](https://github.com/ryankarlos/pandas/blob/2e7c6d17753711fcc0fdeff059fa7c6393dca534/scripts/validate_docstrings.py) !

 I have made additions to the validate_docstring.py and test_validate_docstrings.py - to check for the order of sections. However it is not easy to check this for all docstrings running scripts/validate_docstring.py as suggested in the issue - there is a lot of verbose with 'deprecated' warnings. Any suggestions ? Travis giving errors in Test validator, not sure why. Please merge master and can you not run `ci/script_single.sh` to see what the error is. 

I imagine this is because not all our docstrings are ordered correctly as the CI logs suggest:

`E           assert 'Examples section should not be before Parameters'` 

We can omit running the ordering check on certain files for now and create an issue to follow up and fix.

Depends what @datapythonista thinks :) @ryankarlos do you have time to udate based on comments, and resolve the conflicts? @datapythonista I’ll try and work on this tonight as well as #23152 concurrently I've been researching on how to do this with numpydoc, and I ended up implementing this myself. Closing this, as superseded by #23607.