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

closes #3850.

Updates 10min.rst to demonstrate isin


Labels:
name: Docs

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

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.

You may need to put pandas in front of Series

@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.

@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?)

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.

@clham It is possibly another issue with out python 3 compat for building the docs. See my comment here: https://github.com/pydata/pandas/pull/5530#issuecomment-33326749 (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?

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

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"

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)

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

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