<h4 dir="auto">Problem description: ".resample" documentation too vague</h4>
<p dir="auto">url: <a href="http://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.resample.html" rel="nofollow">http://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.resample.html</a></p>
<p dir="auto">e.g.:</p>
<p dir="auto"><strong>rule:</strong> "The offset string or object representing target conversion"</p>
<p dir="auto">No idea what is meant by that but a more helpful description to amateurs like me seems to be e.g.:<br>
'a frequency or valid rule for re-sampling an inputted time-series object. Expressed as a string. '</p>
<p dir="auto">Where is the documentation on 'how'? Or is it deprecated. If so, why is it there?</p>
<p dir="auto">There are 13 parameters with only 9 descriptions.</p>
<p dir="auto">Lastly, I think that if documentation is structured, a better suited layout is in the form of tables with clear headers but I suppose the documentation is too far in for anyone to be motivated to change it!</p>
<p dir="auto">Best</p>
<p dir="auto">Ed</p>
<p dir="auto">Reference docs (see: <a href="http://pandas.pydata.org/pandas-docs/stable/generated/pandas.Series.resample.html" rel="nofollow">http://pandas.pydata.org/pandas-docs/stable/generated/pandas.Series.resample.html</a>):</p>
<ul class="contains-task-list">
<li class="task-list-item"><input type="checkbox" id="" disabled="" class="task-list-item-checkbox"> Add to docs the list of options that can be passed to <code class="notranslate">fill_method</code>. Some of which are <code class="notranslate">pad</code>, <code class="notranslate">bfill</code>, <code class="notranslate">ffill</code>.<br>
-- The list seems to be documented for the <code class="notranslate">method</code> on <code class="notranslate">fillna</code>: <a href="http://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.fillna.html#pandas.DataFrame.fillna" rel="nofollow">http://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.fillna.html#pandas.DataFrame.fillna</a></li>
<li class="task-list-item"><input type="checkbox" id="" disabled="" class="task-list-item-checkbox" checked=""> The <code class="notranslate">convention</code> parameter is not well documented. It is unclear what the values of <code class="notranslate">end</code> or <code class="notranslate">start</code> means (and the associated aliases). (<a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="208272187" data-permission-text="Title is private" data-url="https://github.com/pandas-dev/pandas/issues/15432" data-hovercard-type="issue" data-hovercard-url="/pandas-dev/pandas/issues/15432/hovercard" href="https://github.com/pandas-dev/pandas/issues/15432">#15432</a> is dupe), PR <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="243202766" data-permission-text="Title is private" data-url="https://github.com/pandas-dev/pandas/issues/16965" data-hovercard-type="pull_request" data-hovercard-url="/pandas-dev/pandas/pull/16965/hovercard" href="https://github.com/pandas-dev/pandas/pull/16965">#16965</a></li>
<li class="task-list-item"><input type="checkbox" id="" disabled="" class="task-list-item-checkbox" checked=""> The <code class="notranslate">kind</code> parameters is also unclear. The best I could get from it was a infinite stack recursion: <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="20220091" data-permission-text="Title is private" data-url="https://github.com/pandas-dev/pandas/issues/5026" data-hovercard-type="issue" data-hovercard-url="/pandas-dev/pandas/issues/5026/hovercard" href="https://github.com/pandas-dev/pandas/issues/5026">#5026</a>. (<a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="286106062" data-permission-text="Title is private" data-url="https://github.com/pandas-dev/pandas/issues/19084" data-hovercard-type="pull_request" data-hovercard-url="/pandas-dev/pandas/pull/19084/hovercard" href="https://github.com/pandas-dev/pandas/pull/19084">#19084</a>)</li>
<li class="task-list-item"><input type="checkbox" id="" disabled="" class="task-list-item-checkbox"> <code class="notranslate">how</code> can also be a function or list of functions, not only a string</li>
<li class="task-list-item"><input type="checkbox" id="" disabled="" class="task-list-item-checkbox"> for the <code class="notranslate">closed</code> and <code class="notranslate">label</code> keywords, I think it could be explained which are default in which cases (which is not always the same). In every case, that <code class="notranslate">label='right'</code> is default as stated in the docs (<a href="http://pandas.pydata.org/pandas-docs/dev/timeseries.html#up-and-downsampling" rel="nofollow">http://pandas.pydata.org/pandas-docs/dev/timeseries.html#up-and-downsampling</a>) is not true.</li>
<li class="task-list-item"><input type="checkbox" id="" disabled="" class="task-list-item-checkbox"> A list of all available methods for <code class="notranslate">how</code></li>
</ul>
<p dir="auto">Tutorial docs:</p>
<ul class="contains-task-list">
<li class="task-list-item"><input type="checkbox" id="" disabled="" class="task-list-item-checkbox"> example using custom <code class="notranslate">how</code> function</li>
<li class="task-list-item"><input type="checkbox" id="" disabled="" class="task-list-item-checkbox"> example showing how to use <code class="notranslate">base</code></li>
</ul>