Improved documentation with information about behavior of client throttling in case of failures