correction in docs
refactor gambles (not Cone-part)
make more doctests pass (argument reordering; to fundamentally fix later)