DOC: GH3850, add .isin to 10min.rst

[clham]

closes #3850.

Updates 10min.rst to demonstrate isin

[jorisvandenbossche]

can you add something like using the :func:~Series.isin method (to have the link to the isin docstring page)?

[jorisvandenbossche]

@clham Thanks for your contribution! I just added some comments.

[clham]

Fixed all but using the :func:~Series.isin method -- I can't seem to get any variety of syntax to compile so that the link works. Thanks for the patience on my first --ever-- PR.

[cpcloud]

You may need to put pandas in front of Series

[clham]

@cpcloud, I tried that along with a few other syntax. Interestingly, when I compile the docs, many of the Series.xxx links in api.rst also fail to generate (including Series.isin). To skirt it, I can just cut and paste the working (for everyone else) reference from the API file :func:~Series.isin``, but, considering I can't get it to compile properly, it seems unkosher? Thanks again for the patience.

[jorisvandenbossche]

@clham Do you get any warning or error messages? Because normally this should just work, and also strange that api.rst is not building correctly (what is exactly not working? is it only the link that does not work but it renders well for the rest?)

[clham]

Pages render properly, however it looks like the actual docstrings are not being produced. In the Series.xxx sections of api.rst, the only working links are:

Series
Series.values
Series.dtype
Series.ftype
Series.at
series.iat
series.ix
series.loc
series.iloc

Several other sections have similar problems.

The sourcedoc pages do compile, but the body of the page is blank other than the header.

The following is the first error I get when I run python make.py html:

reading sources... [  0%] generated/pandas.DataFrame.__iter__
Traceback (most recent call last):
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/sphinx/ext/autodoc.py", line 321, in import_object
    __import__(self.modname)
ImportError: No module named 'pandas.DataFrame

I'm not sure if this is related (or useful), but in ipython, import pandas.DataFrame fails, while from pandas import DataFrame succeeds.

[jorisvandenbossche]

@clham It is possibly another issue with out python 3 compat for building the docs. See my comment here: #5530 (comment) (first point, seems the same error message). For me this appeared only after rebuilding the docs, not with a clean build.

Can you try a clean build (just do first python make.py clean)? See if it works then?

[clham]

@jorisvandenbossche That worked. Also, that link to #5530 was crazy informative.

[jorisvandenbossche]

OK, @clham, to get this merged, can you first squash the commits? (so you have only one commit for this addition)

You can normally do this with git rebase -i HEAD~4.

Another tip: never merge master in your branch, always rebase (git rebase upstream/master), then you don't get this commits like "Merge remote-tracking branch 'upstream/master' into gh3850"

[jorisvandenbossche]

BTW, if you find other fixes for the issues with python 3 you encounter (and mentioned in #5530), we are glad to improve this (but I myself am not working with python 3 yet for the docs)

[clham]

Well... That was an adventure in git. I think I'm good at this point -- please let me know otherwise.

[jorisvandenbossche]

Yep, looking good now! Thanks again, and your first PR can be merged :-)