DOC: Add information on kind parameter to resample docstring
xref #5023

When working on another issue I couldn't find any information in the ``resample`` [docstring](https://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.resample.html) on the ``kind`` parameter so I added it. There was some relevant information in the resample [section](http://pandas.pydata.org/pandas-docs/stable/timeseries.html#resampling) of the time-series documentation.
  
Hello @reidy-p! Thanks for updating the PR.



Cheers ! There are no PEP8 issues in this Pull Request. :beers: 

##### Comment last updated on January 04, 2018 at 20:38 Hours UTC actually want to get rid of this parameter, but ok thanks!