fixed probabilities documentation, added optional argument for chance and added documentation for chance