This fixes the example, but there's an open question about hypergeom.ppf() on ticket 1421. That should be checked before closing it.
DOC: stats.distributions: update discrete example. Closes #1421.
DOC: stats.distributions: slight rewording of hypergeom example.
@josef-pkt: The second commit was in response to your review. I rebased this branch, so your comment doesn't show up on the PR anymore.