Elytron contains a lot of mappers, transformers, decoders etc. which can be used in security domain as well as in mechanism definition. For correct understanding this resources there is needed to include some identity flow in documentation. It should be aimed at:

• what exactly is reason for usage particular mappers, transformers, decoders etc. in security domain and mechanisms
  • why they are used and how it affects final identity
• order of usage of different mappers, transformers, decoders etc. in security domain and mechanisms