pac4j-118: Improve documentation and core concepts

Updated after @miremond's code review