[Auth] - base authentication adapter gets authentication handler passed via reference
       - removed some comments (put them into docs)
[Docs] - documented auth concept

Signed-off-by: Ralf Grawunder <r.grawunder@googlemail.com>