pod for session
make the explanation clearer
Merge remote-tracking branch 'szabgab/docs' into devel

Fixes #1007