A meagre documentation of the public interface...
connection & backoff