DOC: Correct and expand Series.nonzero docstring

- Mention that a tuple of indices is returned and explain why.
- Instead of numpy.ndarray.nonzero, point to numpy.nonzero, which has
  the full documentation.
- Add example.
Merge pull request #8247 from kyleam/fix-nonzero-docstring

DOC: Correct Series.nonzero docstring