updated documentation to include chance and probability