Updated readme with description of timeouts and persistance factor
updated with comments to functions and types