CLN/ENH: clean up docstrings remove some cruft and generalize
CLN/ENH: clean up docstrings remove some cruft and generalize

MJuddBooth/pandas,harisbal/pandas,winklerand/pandas,jmmease/pandas,linebp/pandas,datapythonista/pandas,Winand/pandas,pandas-dev/pandas,jmmease/pandas,rs2/pandas,DGrady/pandas,GuessWhoSamFoo/pandas,DGrady/pandas,pandas-dev/pandas,gfyoung/pandas,cython-testbed/pandas,TomAugspurger/pandas,harisbal/pandas,cython-testbed/pandas,nmartensen/pandas,Winand/pandas,datapythonista/pandas,pratapvardhan/pandas,jorisvandenbossche/pandas,linebp/pandas,toobaz/pandas,kdebrab/pandas,toobaz/pandas,MJuddBooth/pandas,DGrady/pandas,toobaz/pandas,jorisvandenbossche/pandas,cbertinato/pandas,kdebrab/pandas,jorisvandenbossche/pandas,rs2/pandas,GuessWhoSamFoo/pandas,gfyoung/pandas,rs2/pandas,zfrenchee/pandas,louispotok/pandas,nmartensen/pandas,gfyoung/pandas,gfyoung/pandas,cbertinato/pandas,pandas-dev/pandas,pandas-dev/pandas,winklerand/pandas,cbertinato/pandas,GuessWhoSamFoo/pandas,dsm054/pandas,datapythonista/pandas,dsm054/pandas,linebp/pandas,cbertinato/pandas,kdebrab/pandas,winklerand/pandas,TomAugspurger/pandas,cython-testbed/pandas,zfrenchee/pandas,jmmease/pandas,datapythonista/pandas,winklerand/pandas,MJuddBooth/pandas,dsm054/pandas,harisbal/pandas,linebp/pandas,GuessWhoSamFoo/pandas,Winand/pandas,jorisvandenbossche/pandas,nmartensen/pandas,louispotok/pandas,louispotok/pandas,dsm054/pandas,amolkahat/pandas,DGrady/pandas,nmartensen/pandas,kdebrab/pandas,pratapvardhan/pandas,DGrady/pandas,jreback/pandas,jreback/pandas,cython-testbed/pandas,toobaz/pandas,zfrenchee/pandas,nmartensen/pandas,jmmease/pandas,harisbal/pandas,winklerand/pandas,louispotok/pandas,TomAugspurger/pandas,MJuddBooth/pandas,harisbal/pandas,GuessWhoSamFoo/pandas,nmartensen/pandas,dsm054/pandas,pratapvardhan/pandas,zfrenchee/pandas,cbertinato/pandas,louispotok/pandas,winklerand/pandas,cython-testbed/pandas,DGrady/pandas,jreback/pandas,jmmease/pandas,jreback/pandas,zfrenchee/pandas,kdebrab/pandas,MJuddBooth/pandas,amolkahat/pandas,jmmease/pandas,Winand/pandas,Winand/pandas,gfyoung/pandas,pratapvardhan/pandas,amolkahat/pandas,rs2/pandas,amolkahat/pandas,TomAugspurger/pandas,linebp/pandas,Winand/pandas,linebp/pandas,pratapvardhan/pandas,jreback/pandas,amolkahat/pandas,toobaz/pandas