DOC: Examples of monotonic/non-monotonic label-based indexing

[nileracecrew]

Just ran into this gotcha and almost filed it as a bug report. Added a few examples to fill in the section header.

[jorisvandenbossche]

typo in 'montonically'

[jorisvandenbossche]

@nileracecrew Thanks for this nice contribution to the docs! (that title was indeed missing an explanation ;-))

It is certainly good to keep it here, but we maybe should also consider to include a similar explanation in the indexing docs itself.

[nileracecrew]

You're welcoem @jorisvandenbossche. Seems like this behavior is most likely to show up when you have other problems (in my case corrupted data, as well as an in another issue I found), but it is surprising.

I made the suggested edits and re-committed.

[jreback]

instead a empty frame use a range for number (range(6))

[nileracecrew]

Sorry, I don't quite understand your meaning. Do you mean fill the example DataFrame with numbers, or use range(6) as an index instead of the empty DataFrame example, or something else?

[jreback]

fill with numbers

[gfyoung]

@nileracecrew : If I'm not mistaken (unless the tests do check these files), since your fixes are purely documentation related, you should put [ci skip] in your commit message because you aren't changing any code. Every time you make a change to your PR, you are adding another build to Travis (you currently have five). Unless these .rst files are checked, I would suggest if someone could cancel all of your builds and you could put that "ci skip" tag in your commit.

[jreback]

hmm actually what I mean is we need to more references to this section as this is certainly easy to miss. maybe can do that in antother PR though.

[jreback]

actually make these all ipython blocks rather than code-blocks.

[jorisvandenbossche]

In this case it makes sense to use code blocks I think, as below there are some error messages shown (and they don't need to be shown fully).
But, maybe use IPython prompts for uniformity with the rest of the document?

[jreback]

pls squash when you update

[nileracecrew]

Is there a quick way to render a single .rst file to see the output? GitHub doesn't render the ipython blocks.

[jreback]

http://pandas-docs.github.io/pandas-docs-travis/contributing.html#how-to-build-the-pandas-documentation

[nileracecrew]

sorry, didn't mean to push that here

[jreback]

thanks!