re-worked documentation and raised issues in TODO about end user authentication.