documentation for new client modes