DOC: update the DataFrame.pivot	docstring (#20250)
DOC: update the DataFrame.pivot	docstring (#20250)

* DOC: DataFrame.pivot

* DOC: grammar

* Fixing pivot

* Added Raises and example

* Say what to do

* Refer to user guide

* Fixed name

dsm054/pandas,cython-testbed/pandas,pandas-dev/pandas,datapythonista/pandas,jorisvandenbossche/pandas,rs2/pandas,kdebrab/pandas,TomAugspurger/pandas,toobaz/pandas,harisbal/pandas,GuessWhoSamFoo/pandas,harisbal/pandas,jreback/pandas,GuessWhoSamFoo/pandas,GuessWhoSamFoo/pandas,amolkahat/pandas,dsm054/pandas,pandas-dev/pandas,louispotok/pandas,cbertinato/pandas,amolkahat/pandas,cbertinato/pandas,gfyoung/pandas,datapythonista/pandas,MJuddBooth/pandas,TomAugspurger/pandas,rs2/pandas,gfyoung/pandas,cbertinato/pandas,MJuddBooth/pandas,MJuddBooth/pandas,kdebrab/pandas,cython-testbed/pandas,rs2/pandas,cython-testbed/pandas,louispotok/pandas,amolkahat/pandas,cbertinato/pandas,MJuddBooth/pandas,GuessWhoSamFoo/pandas,jreback/pandas,jreback/pandas,GuessWhoSamFoo/pandas,toobaz/pandas,harisbal/pandas,jorisvandenbossche/pandas,jorisvandenbossche/pandas,louispotok/pandas,dsm054/pandas,pratapvardhan/pandas,pratapvardhan/pandas,louispotok/pandas,datapythonista/pandas,gfyoung/pandas,rs2/pandas,pratapvardhan/pandas,toobaz/pandas,kdebrab/pandas,kdebrab/pandas,kdebrab/pandas,harisbal/pandas,TomAugspurger/pandas,toobaz/pandas,gfyoung/pandas,toobaz/pandas,MJuddBooth/pandas,amolkahat/pandas,harisbal/pandas,jreback/pandas,jorisvandenbossche/pandas,pratapvardhan/pandas,pandas-dev/pandas,datapythonista/pandas,dsm054/pandas,jreback/pandas,pandas-dev/pandas,cython-testbed/pandas,louispotok/pandas,amolkahat/pandas,dsm054/pandas,TomAugspurger/pandas,cbertinato/pandas,cython-testbed/pandas,pratapvardhan/pandas,gfyoung/pandas