fix documentation with failover mechanism