DOC/CLN: Cleanups plotting.py

- Some refactoring which should not affects to output.
- Made ``DataFrame.plot`` and ``Series.plot`` should have consistent docstring except differences.
Can you switch those two of order? Then the `marked_right` (which comes after these for DataFrame.plot) comes right after `secondary_y`, which is a bit more logical