added mixing case and documentation