Update documentation to make it future proof
Update documentation to make it future proof

With this change, it is possible to make the functions return the global
timeout and slow threshold without breaking the API and requiring a major
version bump.

pereckerdal/overman,jkp/overman