DOC: improve docstring of function where

[JennaVergeynst]

Clarified parameters cond and other.
Added example with scalar other.

[jreback]

can you update same for .mask as well.

[jorisvandenbossche]

mask and where now use the same docstring (with only parts of it substituted with the correct value). But keep doing this and providing a better explanation will become rather complex I think. Are you OK with just duplicating the docstring and have one for where and mask separately ?

[jreback]

oh that's right. I don't think duplicating is a good idea. maybe just put an example with mask here as well.

[pep8speaks]

Hello @JennaVergeynst! Thanks for updating the PR.

Cheers ! There are no PEP8 issues in this Pull Request. 🍻

Comment last updated on September 25, 2017 at 12:54 Hours UTC

[codecov]

Codecov Report

Merging #17665 into master will decrease coverage by 0.01%.
The diff coverage is 100%.

@@            Coverage Diff             @@
##           master   #17665      +/-   ##
==========================================
- Coverage   91.23%   91.21%   -0.02%     
==========================================
  Files         163      163              
  Lines       49808    49808              
==========================================
- Hits        45442    45433       -9     
- Misses       4366     4375       +9

Flag	Coverage Δ
#multiple	89.01% <100%> (ø)	⬆️
#single	40.32% <100%> (-0.07%)	⬇️

Impacted Files	Coverage Δ
pandas/core/generic.py	92.07% <100%> (ø)	⬆️
pandas/io/gbq.py	25% <0%> (-58.34%)	⬇️
pandas/core/frame.py	97.73% <0%> (-0.1%)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 83c9205...cf8f081. Read the comment docs.

[jreback]

thanks @JennaVergeynst